Edit

PFND3DDDI_QUERYAUTHENTICATEDCHANNEL callback function (d3dumddi.h)

  • Article

The QueryAuthenticatedChannel function queries an authenticated channel for capability and state information.

Syntax

PFND3DDDI_QUERYAUTHENTICATEDCHANNEL Pfnd3dddiQueryauthenticatedchannel;

HRESULT Pfnd3dddiQueryauthenticatedchannel(
  HANDLE hDevice,
  const D3DDDIARG_QUERYAUTHENTICATEDCHANNEL *unnamedParam2
)
{...}

Parameters

hDevice

A handle to the display device (graphics context).

unnamedParam2

pData [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.

Return value

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.

Remarks

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.

Requirements

Requirement Value
Minimum supported client QueryAuthenticatedChannel is supported beginning with the Windows 7 operating system.
Target Platform Desktop
Header d3dumddi.h (include D3dumddi.h)

See also

ConfigureAuthenticatedChannel

D3DDDIARG_QUERYAUTHENTICATEDCHANNEL