PFND3DDDI_CREATEAUTHENTICATEDCHANNEL Rückruffunktion (d3dumddi.h)

  • Artikel

Die CreateAuthenticatedChannel-Funktion erstellt einen Kanal, den die Microsoft Direct3D-Runtime und der Treiber zum Festlegen und Abfragen von Schutzmaßnahmen verwenden können.

Syntax

PFND3DDDI_CREATEAUTHENTICATEDCHANNEL Pfnd3dddiCreateauthenticatedchannel;

HRESULT Pfnd3dddiCreateauthenticatedchannel(
  HANDLE hDevice,
  D3DDDIARG_CREATEAUTHENTICATEDCHANNEL *unnamedParam2
)
{...}

Parameter

hDevice

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

unnamedParam2

pData [in, out]

Ein Zeiger auf eine D3DDDIARG_CREATEAUTHENTICATEDCHANNEL-Struktur . Bei der Eingabe enthält diese Struktur Informationen, die der Treiber verwenden kann. Bei der Ausgabe gibt der Treiber Informationen in der Struktur an, die die Direct3D-Runtime verwenden kann.

Rückgabewert

CreateAuthenticatedChannel gibt einen der folgenden Werte zurück:

Rückgabecode Beschreibung
S_OK Der Kanal wurde erfolgreich erstellt.
E_OUTOFMEMORY CreateAuthenticatedChannel konnte nicht den erforderlichen Arbeitsspeicher zuordnen, um ihn abzuschließen.
D3DDDIERR_NOTAVAILABLE Der Treiber unterstützt nicht den Kanaltyp, der im ChannelType-Member der D3DDDIARG_CREATEAUTHENTICATEDCHANNEL-Struktur angegeben ist, auf die der pData-Parameter verweist.

Hinweise

Die Runtime übergibt das Handle an den authentifizierten Kanal, den der Treiber im ChannelType-Member der D3DDDIARG_CREATEAUTHENTICATEDCHANNEL-Struktur bei allen nachfolgenden Aufrufen zurückgibt, die das Handle erfordern.

Der Treiber muss das Anzeigegerät (hDevice) nachverfolgen, das zum Erstellen des authentifizierten Kanals verwendet wurde. Der Treiber sollte bei allen nachfolgenden Aufrufen, die diesen erstellten authentifizierten Kanal verwenden (z. B. die AuthenticatedChannelKeyExchange-Funktion ), fehlschlagen, wenn sich das anzeigegerät, das in diesen Aufrufen angegeben wird, von dem Anzeigegerät unterscheidet, das zum Erstellen des authentifizierten Kanals verwendet wurde.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) CreateAuthenticatedChannel wird ab dem Windows 7-Betriebssystem unterstützt.
Zielplattform Desktop
Kopfzeile d3dumddi.h (include D3dumddi.h)

Weitere Informationen

D3DDDIARG_CREATEAUTHENTICATEDCHANNEL