PFND3D11_1DDI_CREATEAUTHENTICATEDCHANNEL fonction de rappel (d3d10umddi.h)

Article
02/06/2025

Crée un objet de canal authentifié. Implémenté par un pilote d’affichage Windows Display Driver (WDDM) 1.2 ou version ultérieure.

Syntaxe

PFND3D11_1DDI_CREATEAUTHENTICATEDCHANNEL Pfnd3d111DdiCreateauthenticatedchannel;

HRESULT Pfnd3d111DdiCreateauthenticatedchannel(
  D3D10DDI_HDEVICE hDevice,
  D3D11_1DDIARG_CREATEAUTHENTICATEDCHANNEL *pCreateData,
  D3D11_1DDI_HAUTHCHANNEL hAuthChannel,
  D3D11_1DDI_HRTAUTHCHANNEL hRTAuthChannel
)
{...}

Paramètres

hDevice

Handle de l’appareil d’affichage (contexte graphique).

pCreateData

Pointeur vers une structure D3D11_1DDIARG_CREATEAUTHENTICATEDCHANNEL. Cette structure spécifie les attributs du canal authentifié à créer.

hAuthChannel

Handle des données privées du pilote pour l’objet de canal authentifié. Pour plus d’informations, consultez la section Remarques.

hRTAuthChannel

Handle de l’objet de canal authentifié que le pilote doit utiliser lorsqu’il revient au runtime Direct3D.

Valeur de retour

Retourne l’une des valeurs suivantes :

code de retour	Description
S_OK	Le canal authentifié a été créé avec succès.
D3DDDIERR_DEVICEREMOVED	La carte graphique a été supprimée.
E_OUTOFMEMORY	La mémoire n’était pas disponible pour terminer l’opération.

Remarques

Le runtime Direct3D appelle CreateAuthenticatedChannel(D3D11_1) une fois qu’il a appelé le CalcPrivateAuthenticatedChannelSize pour déterminer la taille en octets des données privées requises par le pilote pour l’objet de canal authentifié. Le runtime alloue la mémoire pour ces données privées pour le pilote. Le pilote utilise cette mémoire pour stocker des données privées liées à l’objet de canal d’authentification.

Lorsque le runtime appelle CreateAuthenticatedChannel(D3D11_1), il transmet le handle à la mémoire des données privées dans le paramètre hAuthChannel. Ce handle est en fait un pointeur vers la mémoire.

Le pilote doit suivre le handle sur l’appareil d’affichage utilisé pour créer le canal authentifié. Le pilote doit échouer tous les appels suivants qui utilisent ce canal authentifié créé, tel que NegotiateAuthenticatedChannelKeyExchange, 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	Windows 8
serveur minimum pris en charge	Windows Server 2012
plateforme cible	Bureau
d’en-tête	d3d10umddi.h (include D3d10umddi.h)

Voir aussi

CalcPrivateAuthenticatedChannelSize

CreateAuthenticatedChannel(D3D11_1)

D3D11_1DDIARG_CREATEAUTHENTICATEDCHANNEL

NegotiateAuthenticatedChannelKeyExchange

Partager via