structure DXGKARG_DESCRIBEALLOCATION (d3dkmddi.h)

Article
02/06/2025

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 vers une allocation pour laquelle les informations sont demandées. Le pilote a précédemment retourné ce handle dans le membre hAllocation de la structure DXGK_ALLOCATIONINFO d’un appel à la fonction DxgkDdiCreateAllocation du pilote.

[out] Width

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

[out] Height

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

[out] Format

Valeur D3DDDIFORMAT-typée 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 le taux d’actualisation avec lequel la surface principale 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 des attributs de format surface (par exemple, la disposition de 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 de PrivateDriverFormatAttribute pour comparer deux surfaces. Par exemple, une surface A8R8B8G8 800x600 et une surface X8R8B8G8 800x600 doit avoir les mêmes informations dans PrivateDriverFormatAttribute s’ils ont les mêmes attributs de format, qui incluent la disposition de pixels.

[out] Flags

Ce membre est réservé.

Prise en charge à partir de Windows 8.

[out] Rotation

Ce membre est réservé.

Prise en charge à partir de Windows 8.