PFND3DDDI_CREATEAUTHENTICATEDCHANNEL fonction de rappel (d3dumddi.h)
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) |