PFND3DDDI_DESTROYAUTHENTICATEDCHANNEL callback function (d3dumddi.h)

The DestroyAuthenticatedChannel function releases resources for the authenticated channel that the CreateAuthenticatedChannel function creates.

Syntax

PFND3DDDI_DESTROYAUTHENTICATEDCHANNEL Pfnd3dddiDestroyauthenticatedchannel;

HRESULT Pfnd3dddiDestroyauthenticatedchannel(
  HANDLE hDevice,
  const D3DDDIARG_DESTROYAUTHENTICATEDCHANNEL *unnamedParam2
)
{...}

Parameters

hDevice

A handle to the display device (graphics context).

unnamedParam2

pData [in]

A pointer to a D3DDDIARG_DESTROYAUTHENTICATEDCHANNEL structure that contains one member that specifies the handle to the authenticated channel to destroy.

Return value

DestroyAuthenticatedChannel returns one of the following values:

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

Remarks

The driver's DestroyAuthenticatedChannel function should disable any protections that were set through calls to the driver's ConfigureAuthenticatedChannel function with the D3DAUTHETICATEDCONFIGURE_PROTECTION and D3DAUTHENTICATEDCONFIGURE_ENCRYPTIONWHENACCESIBLE GUIDs set. However, the driver should not disable shared surface protection (D3DAUTHETICATEDCONFIGURE_SHAREDRESOURCE).

Requirements

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

See also

ConfigureAuthenticatedChannel

CreateAuthenticatedChannel

D3DDDIARG_DESTROYAUTHENTICATEDCHANNEL