estructura DXGKARG_DESCRIBEALLOCATION (d3dkmddi.h)

Artículo
08/07/2023

La estructura DXGKARG_DESCRIBEALLOCATION describe una asignación existente.

Sintaxis

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;

Miembros

[in] hAllocation

Identificador de una asignación para la que se solicita información. El controlador devolvió previamente este identificador en el miembro hAllocation de la estructura de DXGK_ALLOCATIONINFO desde una llamada a la función DxgkDdiCreateAllocation del controlador.

[out] Width

Ancho de la asignación, en píxeles. El controlador devuelve el valor de ancho.

[out] Height

Alto de la asignación, en píxeles. El controlador devuelve el valor de alto.

[out] Format

Valor con tipo D3DDDIFORMAT que indica el formato de píxel de la asignación. El controlador devuelve el valor de formato.

[out] MultisampleMethod

Estructura D3DDDI_MULTISAMPLINGMETHOD que describe el método de muestreo múltiple que se usa para la asignación. El controlador devuelve la descripción.

[out] RefreshRate

Estructura D3DDDI_RATIONAL que indica la frecuencia de actualización con la que se creó la superficie principal, si procede.

[out] PrivateDriverFormatAttribute

Valor UINT que especifica un atributo de formato privado para la asignación. El controlador especifica atributos de formato de superficie (por ejemplo, el diseño de píxeles de una superficie en mosaico) que, de lo contrario, no puede exponer al sistema operativo.

El sistema operativo usa la información de PrivateDriverFormatAttribute para comparar dos superficies. Por ejemplo, una superficie A8R8B8G8 800x600 y una superficie de X8R8B8G8 800x600 debe tener la misma información en PrivateDriverFormatAttribute si tienen los mismos atributos de formato, lo que incluye el diseño de píxeles.

[out] Flags

Este miembro está reservado.

Se admite a partir de Windows 8.

[out] Rotation

Este miembro está reservado.

Se admite a partir de Windows 8.