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 de l’appareil d’affichage (contexte graphique).
unnamedParam2
pData [in, out]
Pointeur vers une structure D3DDDIARG_CREATEAUTHENTICATEDCHANNEL. Lors de l’entrée, cette structure contient des informations que le pilote peut utiliser. En sortie, le pilote spécifie des informations dans la structure que le runtime Direct3D peut utiliser.
Valeur de retour
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 requise pour qu’elle soit terminée. |
| 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 le paramètre pData pointe. |
Remarques
Le runtime transmet le handle au canal authentifié retourné par le pilote dans le ChannelType membre de la structure D3DDDIARG_CREATEAUTHENTICATEDCHANNEL dans tous les appels suivants qui nécessitent le handle.
Le pilote doit suivre l’appareil d’affichage (hDevice) 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 l’appareil d’affichage spécifié dans ces appels est différent de l’appareil d’affichage utilisé pour créer le canal authentifié.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | CreateAuthenticatedChannel est pris en charge à partir du système d’exploitation Windows 7. |
| plateforme cible | Bureau |
| d’en-tête | d3dumddi.h (include D3dumddi.h) |