PFND3DDDI_QUERYAUTHENTICATEDCHANNEL fonction de rappel (d3dumddi.h)

  • Article

La fonction QueryAuthenticatedChannel interroge un canal authentifié pour obtenir des informations sur la fonctionnalité et l’état.

Syntaxe

PFND3DDDI_QUERYAUTHENTICATEDCHANNEL Pfnd3dddiQueryauthenticatedchannel;

HRESULT Pfnd3dddiQueryauthenticatedchannel(
  HANDLE hDevice,
  const D3DDDIARG_QUERYAUTHENTICATEDCHANNEL *unnamedParam2
)
{...}

Paramètres

hDevice

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

unnamedParam2

pData [in, out]

Pointeur vers une structure de D3DDDIARG_QUERYAUTHENTICATEDCHANNEL qui décrit les informations de canal authentifié à interroger. Cette structure contient une mémoire tampon d’entrée qui décrit la requête et une mémoire tampon de sortie pour retourner les informations interrogées.

Valeur retournée

QueryAuthenticatedChannel retourne l’une des valeurs suivantes :

Code de retour Description
S_OK Le canal authentifié est interrogé avec succès.
E_OUTOFMEMORY QueryAuthenticatedChannel n’a pas pu allouer la mémoire nécessaire à son exécution.

Remarques

La mémoire tampon d’entrée contient le handle du pilote pour le canal authentifié, un numéro de séquence et un GUID qui indique le type de requête. Le pilote doit échouer toutes les requêtes si le pilote n’a pas initialisé précédemment le numéro de séquence via un appel à sa fonction ConfigureAuthenticatedChannel . Le pilote doit également échouer la requête si le numéro de séquence n’est pas supérieur au numéro de séquence de l’appel de requête précédent.

Le pilote doit dupliquer les données d’entrée dans la structure de la mémoire tampon de sortie et signer la structure de sortie de la même façon qu’il gère actuellement les requêtes De protection de sortie (OPM).

À l’exception des situations dans lesquelles l’application spécifie incorrectement une mémoire tampon de sortie trop petite, le pilote doit toujours placer le code de retour dans la structure de sortie. Par conséquent, l’application dispose d’un mécanisme sécurisé pour déterminer le code de retour.

QueryAuthenticatedChannel effectue différentes opérations en fonction de chacun des GUID suivants spécifiés dans la structure d’entrée. Le pilote doit échouer si les tailles de mémoire tampon d’entrée et de sortie ne correspondent pas aux tailles définies pour le GUID spécifié.

Configuration requise

Condition requise Valeur
Client minimal pris en charge QueryAuthenticatedChannel 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

ConfigureAuthenticatedChannel

D3DDDIARG_QUERYAUTHENTICATEDCHANNEL