PFND3DDDI_CONFIGUREAUTHENICATEDCHANNEL fonction de rappel (d3dumddi.h)

  • Article

La fonction ConfigureAuthenticatedChannel définit l’état dans 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 de 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 retournée

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 nécessaire pour qu’il se termine.

Remarques

La mémoire tampon d’entrée contient un code OMAC (Cipher Block Chaining) à une clé que le pilote doit authentifier. La mémoire tampon d’entrée contient également le handle du pilote vers 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 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.

ConfigureAuthenticatedChannel 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 la taille de la mémoire tampon d’entrée ne correspond pas à la taille définie pour le GUID spécifié.

Configuration requise

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

D3DDDIARG_CONFIGUREAUTHENTICATEDCHANNEL