struttura DXGKARG_DESCRIBEALLOCATION (d3dkmddi.h)

Articolo
02/25/2024

La struttura DXGKARG_DESCRIBEALLOCATION descrive un'allocazione esistente.

Sintassi

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;

Members

[in] hAllocation

Handle per un'allocazione per cui sono richieste le informazioni. Il driver ha restituito in precedenza questo handle nel membro hAllocation della struttura DXGK_ALLOCATIONINFO da una chiamata alla funzione DxgkDdiCreateAllocation del driver.

[out] Width

Larghezza dell'allocazione, in pixel. Il driver restituisce il valore di larghezza.

[out] Height

Altezza dell'allocazione, in pixel. Il driver restituisce il valore di altezza.

[out] Format

Valore tipizzato D3DDDIFORMAT che indica il formato pixel dell'allocazione. Il driver restituisce il valore di formato.

[out] MultisampleMethod

Struttura D3DDDI_MULTISAMPLINGMETHOD che descrive il metodo di campionamento multiplo utilizzato per l'allocazione. Il driver restituisce la descrizione.

[out] RefreshRate

Struttura D3DDDI_RATIONAL che indica la frequenza di aggiornamento con cui è stata creata la superficie primaria, se applicabile.

[out] PrivateDriverFormatAttribute

Valore UINT che specifica un attributo di formato privato per l'allocazione. Il driver specifica gli attributi di formato superficie (ad esempio, il layout in pixel di una superficie affiancata) che altrimenti non può esporre al sistema operativo.

Il sistema operativo usa le informazioni in PrivateDriverFormatAttribute per confrontare due superfici. Ad esempio, una superficie A8R8B8G8 800x600 e una superficie X8R8B8G8 800x600 devono avere le stesse informazioni in PrivateDriverFormatAttribute se hanno gli stessi attributi di formato, che includono il layout pixel.

[out] Flags

Questo membro è riservato.

Supportato a partire da Windows 8.

[out] Rotation

Questo membro è riservato.

Supportato a partire da Windows 8.