PFND3DDDI_CONFIGUREAUTHENICATEDCHANNEL Rückruffunktion (d3dumddi.h)

  • Artikel

Die ConfigureAuthenticatedChannel-Funktion legt den Zustand in einem authentifizierten Kanal fest.

Syntax

PFND3DDDI_CONFIGUREAUTHENICATEDCHANNEL Pfnd3dddiConfigureauthenicatedchannel;

HRESULT Pfnd3dddiConfigureauthenicatedchannel(
  HANDLE hDevice,
  const D3DDDIARG_CONFIGUREAUTHENTICATEDCHANNEL *unnamedParam2
)
{...}

Parameter

hDevice

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

unnamedParam2

pData [ein, aus]

Ein Zeiger auf eine D3DDDIARG_CONFIGUREAUTHENTICATEDCHANNEL Struktur, die beschreibt, wie ein authentifizierter Kanal konfiguriert wird. Diese Struktur enthält einen Eingabepuffer, der beschreibt, wie der authentifizierte Kanal konfiguriert wird, und einen Ausgabepuffer mit Konfigurationsinformationen.

Rückgabewert

ConfigureAuthenticatedChannel gibt einen der folgenden Werte zurück:

Rückgabecode Beschreibung
S_OK Der authentifizierte Kanal wurde erfolgreich konfiguriert.
E_OUTOFMEMORY ConfigureAuthenticatedChannel konnte den erforderlichen Arbeitsspeicher nicht zuordnen, damit er vollständig ist.

Hinweise

Der Eingabepuffer enthält einen Nachrichtenauthentifizierungscode im CBC-Modus (One-Key Cipher Block Chaining), den der Treiber authentifizieren muss. Der Eingabepuffer enthält auch das Handle des Treibers für den authentifizierten Kanal, eine Sequenznummer und eine GUID, die den Konfigurationstyp angibt.

Der Treiber sollte ConfigureAuthenticatedChannel fehlschlagen, wenn die Eingabe-OMAC nicht übereinstimmt, wenn die Sequenznummer nicht größer als eine Sequenznummer ist, die in einem vorherigen Aufruf angegeben wurde, oder wenn die Sequenznummer noch nicht initialisiert wurde (die Ausnahme für diese letzte Regel gilt für den Initialisierungsaufruf selbst).

Der Treiber sollte die Eingabedaten in der Struktur des Ausgabepuffers duplizieren und die Ausgabestruktur identisch mit der aktuellen Verarbeitung von OPM-Abfragen ( Output Protection Manager ) signieren.

Mit Ausnahme der Situationen, in denen die Anwendung fälschlicherweise einen zu kleinen Ausgabepuffer angibt, sollte der Treiber den Rückgabecode immer in der Ausgabestruktur platzieren. Daher verfügt die Anwendung über einen sicheren Mechanismus, um den Rückgabecode zu bestimmen.

ConfigureAuthenticatedChannel führt unterschiedliche Vorgänge aus, abhängig von den folgenden GUIDs, die in der Eingabestruktur angegeben sind. Der Treiber sollte fehlschlagen, wenn die Größe des Eingabepuffers nicht mit der Größe übereinstimmt, die für die angegebene GUID definiert ist.

Anforderungen

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

Weitere Informationen

D3DDDIARG_CONFIGUREAUTHENTICATEDCHANNEL