IDirect3DDevice9Video::CreateAuthenticatedChannel method (d3d9.h)

Article
02/22/2024

Creates a channel to communicate with the Direct3D device or the graphics driver.

Syntax

HRESULT CreateAuthenticatedChannel(
  D3DAUTHENTICATEDCHANNELTYPE    ChannelType,
  IDirect3DAuthenticatedChannel9 **ppAuthenticatedChannel,
  HANDLE                         *pChannelHandle
);

Parameters

ChannelType

Specifies the type of channel, as a member of the D3DAUTHENTICATEDCHANNELTYPE enumeration.

ppAuthenticatedChannel

Receives a pointer to the IDirect3DAuthenticatedChannel9 interface. The caller must release the interface.

pChannelHandle

Receives a pointer to a handle for the channel.

Return value

If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Remarks

If the ChannelType parameter is D3DAUTHENTICATEDCHANNEL_D3D9, the method creates a channel with the Direct3D device. This type of channel does not support authentication.

If ChannelType is D3DAUTHENTICATEDCHANNEL_DRIVER_SOFTWARE or D3DAUTHENTICATEDCHANNEL_DRIVER_HARDWARE, the method creates an authenticated channel with the graphics driver.

Requirements

Requirement	Value
Minimum supported client	Windows 7 [desktop apps only]
Minimum supported server	Windows Server 2008 R2 [desktop apps only]
Target Platform	Windows
Header	d3d9.h