PFND3D11_1DDI_CREATEAUTHENTICATEDCHANNEL fonction de rappel (d3d10umddi.h)

Article
02/26/2024

Crée un objet de canal authentifié. Implémenté par un pilote d’affichage en mode utilisateur Windows (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 Notes.

hRTAuthChannel

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

Valeur retournée

Renvoie 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) après avoir appelé le CalcPrivateAuthenticatedChannelSize du pilote 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 de données privée dans le paramètre hAuthChannel . Ce handle est en fait un pointeur vers la mémoire.

Le pilote doit suivre le handle du périphérique d’affichage qui a été 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 le périphérique d’affichage spécifié dans ces appels est différent de l’appareil d’affichage utilisé pour créer le canal authentifié.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 8
Serveur minimal pris en charge	Windows Server 2012
Plateforme cible	Desktop (Expérience utilisateur)
En-tête	d3d10umddi.h (include D3d10umddi.h)

Voir aussi

CalcPrivateAuthenticatedChannelSize

CreateAuthenticatedChannel(D3D11_1)

D3D11_1DDIARG_CREATEAUTHENTICATEDCHANNEL

NegotiateAuthenticatedChannelKeyExchange

Partager via