DXGKARG_DESCRIBEALLOCATION structure (d3dkmddi.h)

Article
02/23/2024

La structure DXGKARG_DESCRIBEALLOCATION décrit une allocation existante.

Syntaxe

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;

Membres

[in] hAllocation

Handle à une allocation pour laquelle des informations sont demandées. Le pilote a précédemment retourné ce handle dans le membre hAllocation de la structure DXGK_ALLOCATIONINFO à partir d’un appel à la fonction DxgkDdiCreateAllocation du pilote.

[out] Width

Largeur de l’allocation, en pixels. Le pilote retourne la valeur width.

[out] Height

Hauteur de l’allocation, en pixels. Le pilote retourne la valeur height.

[out] Format

Valeur de type D3DDDIFORMAT qui indique le format de pixel de l’allocation. Le pilote retourne la valeur de format.

[out] MultisampleMethod

Structure D3DDDI_MULTISAMPLINGMETHOD qui décrit la méthode d’échantillonnage multiple utilisée pour l’allocation. Le pilote retourne la description.

[out] RefreshRate

Structure D3DDDI_RATIONAL qui indique la fréquence d’actualisation avec laquelle la surface primaire a été créée, le cas échéant.

[out] PrivateDriverFormatAttribute

Valeur UINT qui spécifie un attribut de format privé pour l’allocation. Le pilote spécifie les attributs de format de surface (par exemple, la disposition en pixels d’une surface en mosaïque) qu’il ne peut pas exposer au système d’exploitation.

Le système d’exploitation utilise les informations contenues dans PrivateDriverFormatAttribute pour comparer deux surfaces. Par exemple, une surface A8R8B8G8 de 800 x 600 et une surface X8R8B8G8 de 800 x 600 doivent avoir les mêmes informations dans PrivateDriverFormatAttribute si elles ont les mêmes attributs de format, notamment la disposition de pixels.

[out] Flags

Ce membre est réservé.

Pris en charge à partir de Windows 8.

[out] Rotation

Ce membre est réservé.

Pris en charge à partir de Windows 8.