Edit

PFND3DDDI_CONFIGUREAUTHENICATEDCHANNEL callback function (d3dumddi.h)

  • Article

The ConfigureAuthenticatedChannel function sets state within an authenticated channel.

Syntax

PFND3DDDI_CONFIGUREAUTHENICATEDCHANNEL Pfnd3dddiConfigureauthenicatedchannel;

HRESULT Pfnd3dddiConfigureauthenicatedchannel(
  HANDLE hDevice,
  const D3DDDIARG_CONFIGUREAUTHENTICATEDCHANNEL *unnamedParam2
)
{...}

Parameters

hDevice

A handle to the display device (graphics context).

unnamedParam2

pData [in, out]

A pointer to a D3DDDIARG_CONFIGUREAUTHENTICATEDCHANNEL structure that describes how to configure an authenticated channel. This structure contains an input buffer that describes how to configure the authenticated channel and an output buffer with configuration information.

Return value

ConfigureAuthenticatedChannel returns one of the following values:

Return code Description
S_OK The authenticated channel is successfully configured.
E_OUTOFMEMORY ConfigureAuthenticatedChannel could not allocate the required memory for it to complete.

Remarks

The input buffer contains a One-key Cipher Block Chaining (CBC)-mode message authentication code (OMAC) that the driver must authenticate. The input buffer also contains the driver's handle to the authenticated channel, a sequence number, and a GUID that indicates the configuration type.

The driver should fail ConfigureAuthenticatedChannel if the input OMAC does not match, if the sequence number is not greater than a sequence number that was specified in a previous call, or if the sequence number has not yet been initialized (the exception to this last rule is for the initialization call itself).

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.

ConfigureAuthenticatedChannel performs different operations depending on each of following GUIDs that is specified in the input structure. The driver should fail if the input buffer size does not match the size that is defined for the specified GUID.

Requirements

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

See also

D3DDDIARG_CONFIGUREAUTHENTICATEDCHANNEL