D3DDDIARG_QUERYAUTHENTICATEDCHANNEL-Struktur (d3dumddi.h)

  • Artikel

Die D3DDDIARG_QUERYAUTHENTICATEDCHANNEL-Struktur beschreibt authentifizierte Kanalinformationen, die mithilfe der QueryAuthenticatedChannel-Funktion abgefragt werden sollen.

Syntax

typedef struct _D3DDDIARG_QUERYAUTHENICATEDCHANNEL {
  [in]     UINT       InputSize;
  [in]     const VOID *pInputData;
  [in]     UINT       OutputSize;
  [in/out] VOID       *pOutputData;
} D3DDDIARG_QUERYAUTHENTICATEDCHANNEL;

Member

[in] InputSize

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

[in] pInputData

Ein Zeiger auf einen Puffer, der die abzufragenden Informationen beschreibt. Der Puffer, auf den pInputData verweist, ist identisch mit dem Eingabepuffer, der an die IDirect3DAuthenticatedChannel::Query-Methode übergeben wird. Weitere Informationen zu IDirect3DAuthenticatedChannel::Query finden Sie in der Windows SDK-Dokumentation.

[in] OutputSize

Die Größe der Ausgabedaten in Bytes, auf die das pOutputData-Element verweist.

[in/out] pOutputData

Ein Zeiger auf einen Puffer, der die Von der QueryAuthenticatedChannel-Funktion zurückgegebenen Informationen beschreibt. Der Puffer, auf den pOutputData verweist, ist identisch mit dem Ausgabepuffer, den die IDirect3DAuthenticatedChannel::Query-Methode zurückgibt.

Hinweise

Die Definitionen der Eingabe- und Ausgabepuffer, auf die die pInputData - und pOutputData-Member verweisen, hängen vom Informationstyp ab. Das erste Element des Eingabepuffers ist immer eine D3DAUTHENTICATEDCHANNEL_QUERY_INPUT-Struktur, deren QueryType-Member den Typ der abzufragenden Informationen identifiziert.

Die Definition des Ausgabepuffers hängt auch von den Informationen ab, die die QueryAuthenticatedChannel-Funktion abfragt . Der erste Member des Ausgabepuffers ist jedoch immer eine D3DAUTHENTICATEDCHANNEL_QUERY_OUTPUT-Struktur, deren Member die folgenden Informationen angeben:

  • Das omac-Element identifiziert den Nachrichtenauthentifizierungscode (OMAC) im CBC-Modus (One-Key Cipher Block Chaining), der es dem Aufrufer ermöglicht, den gesamten Puffer zu authentifizieren, wodurch Man-in-the-Middle-Angriffe verhindert werden.
  • Die Member QueryType, hChannel und SequenceNumber aus dem Eingabepuffer verhindern Replayangriffe.

Anforderungen

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

Weitere Informationen

QueryAuthenticatedChannel