PFND3D11_1DDI_CREATEAUTHENTICATEDCHANNEL Rückruffunktion (d3d10umddi.h)

  • Artikel

Erstellt ein authentifizierte Kanalobjekt. Wird von einem Windows Display Driver Model (WDDM) 1.2 oder höher für den Benutzermodus-Anzeigetreiber implementiert.

Syntax

PFND3D11_1DDI_CREATEAUTHENTICATEDCHANNEL Pfnd3d111DdiCreateauthenticatedchannel;

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

Parameter

hDevice

Ein Handle für das Anzeigegerät (Grafikkontext).

pCreateData

Ein Zeiger auf eine D3D11_1DDIARG_CREATEAUTHENTICATEDCHANNEL-Struktur . Diese Struktur gibt die Attribute des zu erstellenden authentifizierten Kanals an.

hAuthChannel

Ein Handle für die privaten Daten des Treibers für das authentifizierte Kanalobjekt. Weitere Informationen finden Sie im Abschnitt mit Hinweisen.

hRTAuthChannel

Ein Handle für das authentifizierte Kanalobjekt, das der Treiber verwenden sollte, wenn er die Direct3D-Runtime zurückruft.

Rückgabewert

Gibt einen der folgenden Werte zurück:

Rückgabecode Beschreibung
S_OK Der authentifizierte Kanal wurde erfolgreich erstellt.
D3DDDIERR_DEVICEREMOVED Der Grafikkarte wurde entfernt.
E_OUTOFMEMORY Arbeitsspeicher war nicht verfügbar, um den Vorgang abzuschließen.

Hinweise

Die Direct3D-Runtime ruft CreateAuthenticatedChannel(D3D11_1) auf, nachdem sie die CalcPrivateAuthenticatedChannelSize des Treibers aufgerufen hat, um die Größe in Bytes für die privaten Daten zu bestimmen, die der Treiber für das authentifizierte Kanalobjekt benötigt. Die Runtime weist den Arbeitsspeicher für diese privaten Daten für den Treiber zu. Der Treiber verwendet diesen Arbeitsspeicher, um private Daten zu speichern, die sich auf das Authentifizierungskanalobjekt beziehen.

Wenn die Runtime CreateAuthenticatedChannel(D3D11_1) aufruft, übergibt sie das Handle an den privaten Datenspeicher im hAuthChannel-Parameter . Bei diesem Handle handelt es sich tatsächlich um einen Zeiger auf den Arbeitsspeicher.

Der Treiber muss den Handle für das Anzeigegerät nachverfolgen, das zum Erstellen des authentifizierten Kanals verwendet wurde. Der Treiber sollte alle nachfolgenden Aufrufe, die diesen erstellten authentifizierten Kanal verwenden, fehlschlagen, z . B. NegotiateAuthenticatedChannelKeyExchange, wenn sich das Anzeigegerät, das in diesen Aufrufen angegeben ist, von dem Anzeigegerät unterscheidet, das zum Erstellen des authentifizierten Kanals verwendet wurde.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 8
Unterstützte Mindestversion (Server) Windows Server 2012
Zielplattform Desktop
Kopfzeile d3d10umddi.h (einschließlich D3d10umddi.h)

Weitere Informationen

CalcPrivateAuthenticatedChannelSize

CreateAuthenticatedChannel(D3D11_1)

D3D11_1DDIARG_CREATEAUTHENTICATEDCHANNEL

NegotiateAuthenticatedChannelKeyExchange