Edit

PFND3DDDI_CREATEAUTHENTICATEDCHANNEL callback function (d3dumddi.h)

  • Article

The CreateAuthenticatedChannel function creates a channel that the Microsoft Direct3D runtime and the driver can use to set and query protections.

Syntax

PFND3DDDI_CREATEAUTHENTICATEDCHANNEL Pfnd3dddiCreateauthenticatedchannel;

HRESULT Pfnd3dddiCreateauthenticatedchannel(
  HANDLE hDevice,
  D3DDDIARG_CREATEAUTHENTICATEDCHANNEL *unnamedParam2
)
{...}

Parameters

hDevice

A handle to the display device (graphics context).

unnamedParam2

pData [in, out]

A pointer to a D3DDDIARG_CREATEAUTHENTICATEDCHANNEL structure. On input, this structure contains information that the driver can use. On output, the driver specifies information in the structure that the Direct3D runtime can use.

Return value

CreateAuthenticatedChannel returns one of the following values:

Return code Description
S_OK The channel is successfully created.
E_OUTOFMEMORY CreateAuthenticatedChannel could not allocate the required memory for it to complete.
D3DDDIERR_NOTAVAILABLE The driver does not support the channel type that is specified in the ChannelType member of the D3DDDIARG_CREATEAUTHENTICATEDCHANNEL structure that the pData parameter points to.

Remarks

The runtime passes the handle to the authenticated channel that the driver returns in the ChannelType member of the D3DDDIARG_CREATEAUTHENTICATEDCHANNEL structure in all subsequent calls that require the handle.

The driver must keep track of the display device (hDevice) that was used to create the authenticated channel. The driver should fail all subsequent calls that use this created authenticated channel (for example, the AuthenticatedChannelKeyExchange function) if the display device that is specified in those calls is different from the display device that was used to create the authenticated channel.

Requirements

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

See also

D3DDDIARG_CREATEAUTHENTICATEDCHANNEL