PFND3D11_1DDI_CONFIGUREAUTHENTICATEDCHANNEL Rückruffunktion (d3d10umddi.h)

Verarbeitet eine Anforderung einer Anwendung, um einen authentifizierten Kanal für den Inhaltsschutz zu konfigurieren. Implementiert durch ein Windows Display Driver Model (WDDM) 1.2 oder höherer Anzeigetreiber für den Benutzermodus.

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 zum authentifizierten Kanalobjekt, das über einen Aufruf der Funktion CreateAuthenticatedChannel(D3D11_1) erstellt wurde.

InputDataSize

Die Größe des Arrays in Bytes, das vom 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 Parameter wurden überprüft und festgestellt, dass sie falsch sind.
E_OUTOFMEMORY Der Speicher war nicht verfügbar, um den Vorgang abzuschließen.

Bemerkungen

Das Bytearray, auf das vom pInputData-Parameter verwiesen wird, wird auf folgende Weise formatiert:

  • Dieses Array beginnt mit einer D3D11_1DDI_AUTHENTICATED_CONFIGURE_INPUT Struktur.

  • Die Daten, die dieser Struktur folgen, befinden sich in einem Format, das vom ConfigureType-Element der Struktur angegeben wird.

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

  • D3D11_1DDI_AUTHENTICATED_CONFIGURE_CRYPTO_SESSION_GUID D3D11_1DDI_AUTHENTICATED_CONFIGURE_CRYPTO_SESSION

  • D3D11_1DDI_AUTHENTICATED_CONFIGURE_ENCRYPTION_WHEN_ACCESSIBLE_GUIDD3D11_1DDI_AUTHENTICATED_CONFIGURE_ACCESSIBLE_ENCRYPTION

  • D3D11_1DDI_AUTHENTICATED_CONFIGURE_INITIALIZE_GUIDD3D11_1DDI_AUTHENTICATED_CONFIGURE_INITIALIZE

  • D3D11_1DDI_AUTHENTICATED_CONFIGURE_PROTECTION_GUID D3D11_1DDI_AUTHENTICATED_CONFIGURE_PROTECTION

  • D3D11_1DDI_AUTHENTICATED_CONFIGURE_SHARED_RESOURCE_GUID D3D11_1DDI_AUTHENTICATED_CONFIGURE_SHARED_RESOURCE

Die D3D11_1DDI_AUTHENTICATED_CONFIGURE_INPUT Struktur enthält einen AES-basierten CBC-Nachrichtenauthentifizierungscode (OMAC) der Daten. Der Anzeige-Miniporttreiber muss seinen eigenen OMAC über 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 Display-Miniporttreiber folgt den folgenden Schritten, 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 das ReturnCode-Element auf denselben Rückgabecode festlegen, den er für den ConfigureAuthenticatedChannel(D3D11_1)-Aufruf zurückgibt. Dadurch wird die Anwendung mit einem sicheren Mechanismus für den Zugriff auf den Rückgabecode bereitgestellt.

  3. Der Treiber legt das Omac-Element auf Null fest und berechnet dann einen OMAC für die Daten in der Struktur. Der Treiber legt dann das omac-Element auf den OMAC fest, den er berechnet hat.

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

  • Das omac-Element 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 Funktion ConfigureAuthenticatedChannel(D3D11_1) initialisiert.

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

Anforderungen

   
Unterstützte Mindestversion (Client) Windows 8
Unterstützte Mindestversion (Server) Windows Server 2012
Zielplattform Power BI Desktop
Header d3d10umddi.h (include D3d10umddi.h)

Weitere Informationen

CreateAuthenticatedChannel(D3D11_1)

D3D11_1DDI_AUTHENTICATED_CONFIGURE_INPUT

D3D11_1DDI_AUTHENTICATED_CONFIGURE_OUTPUT