PFND3DDDI_CREATEAUTHENTICATEDCHANNEL fonction de rappel (d3dumddi.h)

  • Article

La fonction CreateAuthenticatedChannel crée un canal que le runtime Microsoft Direct3D et le pilote peuvent utiliser pour définir et interroger des protections.

Syntaxe

PFND3DDDI_CREATEAUTHENTICATEDCHANNEL Pfnd3dddiCreateauthenticatedchannel;

HRESULT Pfnd3dddiCreateauthenticatedchannel(
  HANDLE hDevice,
  D3DDDIARG_CREATEAUTHENTICATEDCHANNEL *unnamedParam2
)
{...}

Paramètres

hDevice

Handle pour le périphérique d’affichage (contexte graphique).

unnamedParam2

pData [in, out]

Pointeur vers une structure D3DDDIARG_CREATEAUTHENTICATEDCHANNEL . En entrée, cette structure contient des informations que le pilote peut utiliser. Lors de la sortie, le pilote spécifie des informations dans la structure que le runtime Direct3D peut utiliser.

Valeur retournée

CreateAuthenticatedChannel retourne l’une des valeurs suivantes :

Code de retour Description
S_OK Le canal est créé avec succès.
E_OUTOFMEMORY CreateAuthenticatedChannel n’a pas pu allouer la mémoire nécessaire pour qu’il se termine.
D3DDDIERR_NOTAVAILABLE Le pilote ne prend pas en charge le type de canal spécifié dans le membre ChannelType de la structure D3DDDIARG_CREATEAUTHENTICATEDCHANNEL vers laquelle pointe le paramètre pData.

Remarques

Le runtime transmet le handle au canal authentifié que le pilote retourne dans le membre ChannelType de la structure D3DDDIARG_CREATEAUTHENTICATEDCHANNEL dans tous les appels suivants qui nécessitent le handle.

Le pilote doit effectuer le suivi du périphérique d’affichage (hDevice) qui a été utilisé pour créer le canal authentifié. Le pilote doit échouer tous les appels suivants qui utilisent ce canal authentifié créé (par exemple, la fonction AuthenticatedChannelKeyExchange ) si le périphérique d’affichage spécifié dans ces appels est différent du périphérique d’affichage utilisé pour créer le canal authentifié.

Configuration requise

Condition requise Valeur
Client minimal pris en charge CreateAuthenticatedChannel est pris en charge à partir du système d’exploitation Windows 7.
Plateforme cible Desktop (Expérience utilisateur)
En-tête d3dumddi.h (inclure D3dumddi.h)

Voir aussi

D3DDDIARG_CREATEAUTHENTICATEDCHANNEL