D3DDDIARG_CONFIGUREAUTHENTICATEDCHANNEL Struktur (d3dumddi.h)

Artikel
02/06/2025

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

Syntax

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

Angehörige

[in] InputSize

Die Größe der Eingabedaten, auf die der pInputData Member 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::Configurefinden Sie in der Windows SDK-Dokumentation.

[in/out] pOutputData

Ein Zeiger auf einen Puffer, der die Informationen beschreibt, die vom ConfigureAuthenticatedChannel-Funktion zurückgegeben werden.

Bemerkungen

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

Der ConfigureType Member identifiziert den festzulegenden Konfigurationsstatus.
Der omac Mitglied identifiziert den CBC-Modus (One-key Cipher Block Chaining)-Nachrichtenauthentifizierungscode (OMAC), der überprüft, ob die Eingabe von einer vertrauenswürdigen Quelle stammt.
Der SequenceNumber Member gibt eine eindeutige Nummer an, die der Treiber verwenden kann, um Replay-Angriffe zu verhindern.

Der pOutputData Member verweist auf eine D3DAUTHENTICATEDCHANNEL_CONFIGURE_OUTPUT Struktur, die den Konfigurationstyp und die Sequenznummer des Ausgabepuffers enthält, um Replay-Angriffe zu verhindern.

Konfigurationsstatus, 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
mindestens unterstützte Client-	D3DDDIARG_CONFIGUREAUTHENTICATEDCHANNEL wird ab dem Windows 7-Betriebssystem unterstützt.
Header-	d3dumddi.h (include D3dumddi.h)

Siehe auch

ConfigureAuthenticatedChannel-

Freigeben über