Edit

D3DDDIARG_QUERYAUTHENTICATEDCHANNEL structure (d3dumddi.h)

  • Article

The D3DDDIARG_QUERYAUTHENTICATEDCHANNEL structure describes authenticated-channel information to query by using the QueryAuthenticatedChannel function.

Syntax

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

Members

[in] InputSize

The size, in bytes, of the input data that the pInputData member points to.

[in] pInputData

A pointer to a buffer that describes the information to query. The buffer that pInputData points to is defined identically to the input buffer that is passed to the IDirect3DAuthenticatedChannel::Query method. For more information about IDirect3DAuthenticatedChannel::Query, see the Windows SDK documentation.

[in] OutputSize

The size, in bytes, of the output data that the pOutputData member points to.

[in/out] pOutputData

A pointer to a buffer that describes the information that the QueryAuthenticatedChannel function returns. The buffer that pOutputData points to is defined identically to the output buffer that the IDirect3DAuthenticatedChannel::Query method returns.

Remarks

The definitions of the input and output buffers to which the pInputData and pOutputData members point, depend on the type of information. The first member of the input buffer is always a D3DAUTHENTICATEDCHANNEL_QUERY_INPUT structure, whose QueryType member identifies the type of information to query.

The definition of the output buffer also depends on the information that the QueryAuthenticatedChannel function queries. However, the first member of the output buffer is always a D3DAUTHENTICATEDCHANNEL_QUERY_OUTPUT structure, whose members specify the following information:

  • The omac member identifies the One-key Cipher Block Chaining (CBC)-mode message authentication code (OMAC) that permits the caller to authenticate the entire buffer, which prevents man-in-the-middle attacks.
  • The QueryType, hChannel, and SequenceNumber members from the input buffer prevent against replay attacks.

Requirements

Requirement Value
Minimum supported client D3DDDIARG_QUERYAUTHENTICATEDCHANNEL is supported beginning with the Windows 7 operating system.
Header d3dumddi.h (include D3dumddi.h)

See also

QueryAuthenticatedChannel