D3DDDIARG_QUERYAUTHENTICATEDCHANNEL-Struktur (d3dumddi.h)
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) |