estrutura DXGKARG_DESCRIBEALLOCATION (d3dkmddi.h)

Artigo
02/23/2024

A estrutura DXGKARG_DESCRIBEALLOCATION descreve uma alocação existente.

Sintaxe

typedef struct _DXGKARG_DESCRIBEALLOCATION {
  [in]  HANDLE                       hAllocation;
  [out] UINT                         Width;
  [out] UINT                         Height;
  [out] D3DDDIFORMAT                 Format;
  [out] D3DDDI_MULTISAMPLINGMETHOD   MultisampleMethod;
  [out] D3DDDI_RATIONAL              RefreshRate;
  [out] UINT                         PrivateDriverFormatAttribute;
  [out] DXGK_DESCRIBEALLOCATIONFLAGS Flags;
  [out] D3DDDI_ROTATION              Rotation;
} DXGKARG_DESCRIBEALLOCATION;

Membros

[in] hAllocation

Um identificador para uma alocação para a qual as informações são solicitadas. O driver retornou anteriormente esse identificador no membro hAllocation da estrutura DXGK_ALLOCATIONINFO de uma chamada para a função DxgkDdiCreateAllocation do driver.

[out] Width

A largura da alocação, em pixels. O driver retorna o valor de largura.

[out] Height

A altura da alocação, em pixels. O driver retorna o valor de altura.

[out] Format

Um valor do tipo D3DDDIFORMAT que indica o formato de pixel da alocação. O driver retorna o valor de formato.

[out] MultisampleMethod

Uma estrutura D3DDDI_MULTISAMPLINGMETHOD que descreve o método de amostragem múltipla usado para a alocação. O driver retorna a descrição.

[out] RefreshRate

Uma estrutura D3DDDI_RATIONAL que indica a taxa de atualização com a qual a superfície primária foi criada, se aplicável.

[out] PrivateDriverFormatAttribute

Um valor UINT que especifica um atributo de formato privado para a alocação. O driver especifica atributos de formato de superfície (por exemplo, o layout de pixel de uma superfície em bloco) que, de outra forma, não pode expor ao sistema operacional.

O sistema operacional usa as informações em PrivateDriverFormatAttribute para comparar duas superfícies. Por exemplo, uma superfície A8R8B8G8 800x600 e uma superfície X8R8B8G8 800x600 devem ter as mesmas informações em PrivateDriverFormatAttribute se tiverem os mesmos atributos de formato, o que inclui o layout de pixel.

[out] Flags

Este membro está reservado.

Com suporte começando com Windows 8.

[out] Rotation

Este membro está reservado.

Com suporte começando com Windows 8.