PFND3DDDI_CREATEAUTHENTICATEDCHANNEL - NtDoc
Native API online documentation, based on the System Informer
(formerly Process Hacker) phnt
headers
// d3dumddi.h
PFND3DDDI_CREATEAUTHENTICATEDCHANNEL Pfnd3dddiCreateauthenticatedchannel;
HRESULT Pfnd3dddiCreateauthenticatedchannel(
HANDLE hDevice,
D3DDDIARG_CREATEAUTHENTICATEDCHANNEL *unnamedParam2
)
{...}
View the official Windows Driver Kit DDI referenceNo description available.
The CreateAuthenticatedChannel function creates a channel that the Microsoft Direct3D runtime and the driver can use to set and query protections.
hDeviceA handle to the display device (graphics context).
unnamedParam2pData [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.
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. |
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.
D3DDDIARG_CREATEAUTHENTICATEDCHANNEL