D3DDDIARG_CONFIGUREAUTHENTICATEDCHANNEL Struktur (d3dumddi.h)

  • Artikel

Die D3DDDIARG_CONFIGUREAUTHENTICATEDCHANNEL-Struktur beschreibt den Zustand, der in einem authentifizierten Kanal mithilfe der Funktion ConfigureAuthenticatedChannel festgelegt wird.

Syntax

typedef struct _D3DDDIARG_CONFIGUREAUTHENICATEDCHANNEL {
  [in]     UINT       InputSize;
  [in]     const VOID *pInputData;
  [in/out] VOID       *pOutputData;
} D3DDDIARG_CONFIGUREAUTHENTICATEDCHANNEL;

Member

[in] InputSize

Die Größe der Eingabedaten in Bytes, auf die das pInputData-Mitglied verweist.

[in] pInputData

Ein Zeiger auf einen Puffer, der die festzulegenden Konfigurationsdaten beschreibt. Die Definition des Eingabepuffers hängt von den festgelegten Konfigurationsdaten ab. Der Puffer, auf den pInputData verweist, ist identisch mit dem Eingabepuffer definiert, der an die IDirect3DAuthenticatedChannel::Configure-Methode übergeben wird. Weitere Informationen zu IDirect3DAuthenticatedChannel::Configure finden Sie in der Dokumentation zum Windows SDK.

[in/out] pOutputData

Ein Zeiger auf einen Puffer, der die Von der Funktion ConfigureAuthenticatedChannel zurückgegebenen Informationen beschreibt.

Hinweise

Das erste Element des Eingabepuffers, auf das das pInputData-Element verweist, ist immer die D3DAUTHENTICATEDCHANNEL_CONFIGURE_INPUT-Struktur, deren Member die folgenden Informationen angeben:

  • Das ConfigureType-Element identifiziert den festzulegenden Konfigurationsstatus.
  • Das omac-Mitglied identifiziert den Nachrichtenauthentifizierungscode im CBC-Modus (One-Key Cipher Block Chaining), der überprüft, ob die Eingabe von einer vertrauenswürdigen Quelle stammt.
  • Das SequenceNumber-Element gibt eine eindeutige Zahl an, die der Treiber verwenden kann, um Wiederholungsangriffe zu verhindern.
Das pOutputData-Element verweist auf eine D3DAUTHENTICATEDCHANNEL_CONFIGURE_OUTPUT-Struktur, die den Konfigurationstyp und die Sequenznummer des Ausgabepuffers enthält, um Wiederholungsangriffe zu verhindern.

Der Konfigurationszustand, dass ein authentifizierter Kanalsatz nicht von einem anderen authentifizierten Kanal deaktiviert werden kann. Ein Aufruf der ConfigureAuthenticatedChannel-Funktion des Treibers mit einem solchen Versuch schlägt fehl.

Anforderungen

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

Weitere Informationen

ConfigureAuthenticatedChannel