PFND3DDDI_QUERYAUTHENTICATEDCHANNEL fonction de rappel (d3dumddi.h)
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 de l’appareil d’affichage (contexte graphique).
unnamedParam2
pData [in, out]
Pointeur vers une structure D3DDDIARG_QUERYAUTHENTICATEDCHANNEL qui décrit les informations de canal authentifiées à 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 de retour
QueryAuthenticatedChannel retourne l’une des valeurs suivantes :
Retourner le code | Description |
---|---|
S_OK | Le canal authentifié est interrogé avec succès. |
E_OUTOFMEMORY | QueryAuthenticatedChannel n’a pas pu allouer la mémoire requise pour qu’elle soit terminée. |
Remarques
La mémoire tampon d’entrée contient le handle du pilote vers 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 manière identique à la façon dont il gère actuellement les requêtes Output Protection Manager (OPM).
À l’exception de ces 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 des opérations différentes 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é.
Exigences
Exigence | Valeur |
---|---|
client minimum pris en charge | QueryAuthenticatedChannel est pris en charge à partir du système d’exploitation Windows 7. |
plateforme cible | Bureau |
d’en-tête | d3dumddi.h (include D3dumddi.h) |