PFND3DDDI_CREATEAUTHENTICATEDCHANNEL callback function

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

Syntax


PFND3DDDI_CREATEAUTHENTICATEDCHANNEL CreateAuthenticatedChannel;

__checkReturn HRESULT APIENTRY CreateAuthenticatedChannel(
  _In_    HANDLE                               hDevice,
  _Inout_ D3DDDIARG_CREATEAUTHENTICATEDCHANNEL *pData
)
{ ... }

Parameters

hDevice [in]

A handle to the display device (graphics context).

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 codeDescription
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

Target platform

Version

CreateAuthenticatedChannel is supported beginning with the Windows 7 operating system.

Header

D3dumddi.h (include D3dumddi.h)

See also

D3DDDIARG_CREATEAUTHENTICATEDCHANNEL

 

 

Send comments about this topic to Microsoft

Show: