Share via

PFND3D11_1DDI_CONFIGUREAUTHENTICATEDCHANNEL Rückruffunktion (d3d10umddi.h)

  • Artikel

Verarbeitet eine Anforderung von einer Anwendung, um einen authentifizierten Kanal für den Inhaltsschutz zu konfigurieren. Wird von einem Windows Display Driver Model (WDDM) 1.2 oder höher für den Benutzermodus-Anzeigetreiber implementiert.

Syntax

PFND3D11_1DDI_CONFIGUREAUTHENTICATEDCHANNEL Pfnd3d111DdiConfigureauthenticatedchannel;

HRESULT Pfnd3d111DdiConfigureauthenticatedchannel(
  D3D10DDI_HDEVICE hDevice,
  D3D11_1DDI_HAUTHCHANNEL hCAuthChannel,
  UINT InputDataSize,
  const VOID *pInputData,
  D3D11_1DDI_AUTHENTICATED_CONFIGURE_OUTPUT *pOutputData
)
{...}

Parameter

hDevice

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

hCAuthChannel

Ein Handle für das authentifizierte Kanalobjekt, das durch einen Aufruf der CreateAuthenticatedChannel(D3D11_1)- Funktion erstellt wurde.

InputDataSize

Die Größe des Arrays in Bytes, das durch den pInputData-Parameter angegeben wird.

pInputData

Ein Zeiger auf ein Bytearray, das Eingabedaten für den Befehl enthält. Weitere Informationen finden Sie im Abschnitt mit Hinweisen.

pOutputData

Ein Zeiger auf eine D3D11_1DDI_AUTHENTICATED_CONFIGURE_OUTPUT-Struktur . Weitere Informationen finden Sie im Abschnitt mit Hinweisen.

Rückgabewert

Gibt einen der folgenden Werte zurück:

Rückgabecode Beschreibung
S_OK Der authentifizierte Kanal wurde erfolgreich konfiguriert.
E_FAIL Der Anzeige-Miniporttreiber unterstützt den angegebenen Befehl nicht.
E_INVALIDARG Die Parameter wurden überprüft und als falsch ermittelt.
E_OUTOFMEMORY Der Arbeitsspeicher war zum Abschließen des Vorgangs nicht verfügbar.

Hinweise

Das Bytearray, auf das vom pInputData-Parameter verwiesen wird, wird wie folgt formatiert:

In der folgenden Liste wird das Format dieser Daten basierend auf dem ConfigureType-Element beschrieben.

Die D3D11_1DDI_AUTHENTICATED_CONFIGURE_INPUT-Struktur enthält einen AES-basierten CBC-Nachrichtenauthentifizierungscode (OMAC) mit einem Schlüssel für die Daten. Der Anzeige-Miniporttreiber muss seinen eigenen OMAC für die Daten berechnen, um die Daten zu authentifizieren. Diese Eingabestruktur enthält auch ein Treiberhandle für den authentifizierten Kanal, eine Sequenznummer und eine GUID, die den Konfigurationstyp angibt.

Der Anzeigeminiporttreiber führt die folgenden Schritte aus, wenn er die D3D11_1DDI_AUTHENTICATED_CONFIGURE_OUTPUT-Struktur initialisiert:

  1. Der Treiber muss die Eingabedaten in die D3D11_1DDI_AUTHENTICATED_CONFIGURE_OUTPUT-Struktur kopieren.

  2. Der Treiber muss den ReturnCode-Member auf denselben Rückgabecode festlegen, den er für den Aufruf ConfigureAuthenticatedChannel(D3D11_1) zurückgibt. Dies bietet der Anwendung einen sicheren Mechanismus für den Zugriff auf den Rückgabecode.

  3. Der Treiber legt den omac-Member auf 0 (null) fest und berechnet dann einen OMAC für die Daten in der -Struktur. Der Treiber legt dann den omac-Member auf den OMAC fest, den er berechnet hat.

Der Display-Miniporttreiber muss unter den folgenden Bedingungen E_INVALIDARG für den ConfigureAuthenticatedChannel-Aufruf zurückgeben:

  • Der omac-Member derD3D11_1DDI_AUTHENTICATED_CONFIGURE_INPUT-Struktur stimmt nicht mit dem OMAC überein, den der Treiber berechnet hat.

  • Die Sequenznummer ist nicht größer als eine Sequenznummer, die in einem vorherigen Konfigurationsaufruf angegeben wurde.

  • Die Sequenznummer wurde noch nicht durch einen Aufruf der ConfigureAuthenticatedChannel(D3D11_1)-Funktion initialisiert.

  • Der InputDataSize-Parameter ist kleiner als die Größe der D3D11_1DDI_AUTHENTICATED_CONFIGURE_INPUT-Struktur plus die Größe der struktur, die vom D3D11_1DDI_AUTHENTICATED_CONFIGURE_INPUT angegeben wird. ConfigureTypemember.

Anforderungen

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

Weitere Informationen

CreateAuthenticatedChannel(D3D11_1)

D3D11_1DDI_AUTHENTICATED_CONFIGURE_INPUT

D3D11_1DDI_AUTHENTICATED_CONFIGURE_OUTPUT