PFND3DDDI_QUERYAUTHENTICATEDCHANNEL - NtDoc
Native API online documentation, based on the System Informer
(formerly Process Hacker) phnt
headers
// d3dumddi.h
PFND3DDDI_QUERYAUTHENTICATEDCHANNEL Pfnd3dddiQueryauthenticatedchannel;
HRESULT Pfnd3dddiQueryauthenticatedchannel(
HANDLE hDevice,
const D3DDDIARG_QUERYAUTHENTICATEDCHANNEL *unnamedParam2
)
{...}
View the official Windows Driver Kit DDI referenceNo description available.
The QueryAuthenticatedChannel function queries an authenticated channel for capability and state information.
hDeviceA handle to the display device (graphics context).
unnamedParam2pData [in, out]
A pointer to a D3DDDIARG_QUERYAUTHENTICATEDCHANNEL structure that describes authenticated-channel information to query. This structure contains an input buffer that describes the query and an output buffer to return the queried information.
QueryAuthenticatedChannel returns one of the following values:
| Return code | Description |
|---|---|
| S_OK | The authenticated channel is successfully queried. |
| E_OUTOFMEMORY | QueryAuthenticatedChannel could not allocate the required memory for it to complete. |
The input buffer contains the driver's handle to the authenticated channel, a sequence number, and a GUID that indicates the type of query. The driver should fail all queries if the driver did not previously initialize the sequence number through a call to its ConfigureAuthenticatedChannel function. The driver should also fail the query if the sequence number is not greater than the sequence number of the previous query call.
The driver should duplicate the input data in the structure of the output buffer and should sign the output structure identically to how it currently handles Output Protection Manager (OPM) queries.
Except for those situations in which the application incorrectly specifies an output buffer that is too small, the driver should always place the return code in the output structure. Therefore, the application has a secure mechanism to determine the return code.
QueryAuthenticatedChannel performs different operations depending on each of following GUIDs that is specified in the input structure. The driver should fail if the input and output buffer sizes do not match the sizes that are defined for the specified GUID.
D3DDDIARG_QUERYAUTHENTICATEDCHANNEL