PFND3DDDI_CONFIGUREAUTHENICATEDCHANNEL fonction de rappel (d3dumddi.h)
La ConfigureAuthenticatedChannel'état des jeux de fonctions au sein d’un canal authentifié.
Syntaxe
PFND3DDDI_CONFIGUREAUTHENICATEDCHANNEL Pfnd3dddiConfigureauthenicatedchannel;
HRESULT Pfnd3dddiConfigureauthenicatedchannel(
HANDLE hDevice,
const D3DDDIARG_CONFIGUREAUTHENTICATEDCHANNEL *unnamedParam2
)
{...}
Paramètres
hDevice
Handle de l’appareil d’affichage (contexte graphique).
unnamedParam2
pData [in, out]
Pointeur vers une structure D3DDDIARG_CONFIGUREAUTHENTICATEDCHANNEL qui décrit comment configurer un canal authentifié. Cette structure contient une mémoire tampon d’entrée qui décrit comment configurer le canal authentifié et une mémoire tampon de sortie avec des informations de configuration.
Valeur de retour
ConfigureAuthenticatedChannel retourne l’une des valeurs suivantes :
| code de retour | Description |
|---|---|
| S_OK | Le canal authentifié est correctement configuré. |
| E_OUTOFMEMORY | ConfigureAuthenticatedChannel n’a pas pu allouer la mémoire requise pour qu’elle soit terminée. |
Remarques
La mémoire tampon d’entrée contient un code d’authentification de message en mode SRC (Cipher Block Chaining) à clé unique que le pilote doit authentifier. La mémoire tampon d’entrée contient également le handle du pilote sur le canal authentifié, un numéro de séquence et un GUID qui indique le type de configuration.
Le pilote doit échouer ConfigurerAuthenticatedChannel si l’entrée OMAC ne correspond pas, si le numéro de séquence n’est pas supérieur à un numéro de séquence spécifié dans un appel précédent, ou si le numéro de séquence n’a pas encore été initialisé (l’exception à cette dernière règle concerne l’appel d’initialisation lui-même).
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.
ConfigureAuthenticatedChannel 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 la taille de la mémoire tampon d’entrée ne correspond pas à la taille définie pour le GUID spécifié.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | ConfigureAuthenticatedChannel est pris en charge à partir du système d’exploitation Windows 7. |
| plateforme cible | Bureau |
| d’en-tête | d3dumddi.h (include D3dumddi.h) |