PFND3D11_1DDI_CREATEAUTHENTICATEDCHANNEL callback function (d3d10umddi.h)

Creates an authenticated channel object. Implemented by a Windows Display Driver Model (WDDM) 1.2 or later user-mode display driver.

Syntax

PFND3D11_1DDI_CREATEAUTHENTICATEDCHANNEL Pfnd3d111DdiCreateauthenticatedchannel;

HRESULT Pfnd3d111DdiCreateauthenticatedchannel(
  D3D10DDI_HDEVICE hDevice,
  D3D11_1DDIARG_CREATEAUTHENTICATEDCHANNEL *pCreateData,
  D3D11_1DDI_HAUTHCHANNEL hAuthChannel,
  D3D11_1DDI_HRTAUTHCHANNEL hRTAuthChannel
)
{...}

Parameters

hDevice

A handle to the display device (graphics context).

pCreateData

A pointer to a D3D11_1DDIARG_CREATEAUTHENTICATEDCHANNEL structure. This structure specifies the attributes of the authenticated channel to be created.

hAuthChannel

A handle to the driver's private data for the authenticated channel object. For more information, see the Remarks section.

hRTAuthChannel

A handle to the authenticated channel object that the driver should use when it calls back into the Direct3D runtime.

Return value

Returns one of the following values:

Return code Description
S_OK The authenticated channel was created successfully.
D3DDDIERR_DEVICEREMOVED The graphics adapter was removed.
E_OUTOFMEMORY Memory was not available to complete the operation.

Remarks

The Direct3D runtime calls CreateAuthenticatedChannel(D3D11_1) after it has called the driver's CalcPrivateAuthenticatedChannelSize to determine the size in bytes for the private data that the driver requires for the authenticated channel object. The runtime allocates the memory for this private data for the driver. The driver uses this memory to store private data that is related to the authentication channel object.

When the runtime calls CreateAuthenticatedChannel(D3D11_1), it passes the handle to the private data memory in the hAuthChannel parameter. This handle is actually a pointer to the memory.

The driver must keep track of the handle to the display device that was used to create the authenticated channel. The driver should fail all subsequent calls that use this created authenticated channel, such as NegotiateAuthenticatedChannelKeyExchange, 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 Windows 8
Minimum supported server Windows Server 2012
Target Platform Desktop
Header d3d10umddi.h (include D3d10umddi.h)

See also

CalcPrivateAuthenticatedChannelSize

CreateAuthenticatedChannel(D3D11_1)

D3D11_1DDIARG_CREATEAUTHENTICATEDCHANNEL

NegotiateAuthenticatedChannelKeyExchange