struttura DXGKARG_OPENALLOCATION (d3dkmddi.h)

Articolo
02/23/2024

La struttura DXGKARG_OPENALLOCATION descrive le allocazioni che il driver miniport di visualizzazione deve aprire.

Sintassi

typedef struct _DXGKARG_OPENALLOCATION {
  [in]     UINT                     NumAllocations;
  [in/out] DXGK_OPENALLOCATIONINFO  *pOpenAllocation;
  [in]     VOID                     *pPrivateDriverData;
  [in]     UINT                     PrivateDriverSize;
  [in]     DXGK_OPENALLOCATIONFLAGS Flags;
  [in]     UINT                     SubresourceIndex;
  [out]    SIZE_T                   SubresourceOffset;
  [out]    UINT                     Pitch;
} DXGKARG_OPENALLOCATION;

Members

[in] NumAllocations

Numero di elementi nella matrice specificati dal membro pOpenAllocation , che rappresenta il numero di allocazioni specifiche del dispositivo da aprire.

[in/out] pOpenAllocation

Matrice di strutture DXGK_OPENALLOCATIONINFO per l'apertura delle allocazioni.

[in] pPrivateDriverData

Puntatore a un blocco di dati privati passati dal driver di visualizzazione in modalità utente al driver miniport di visualizzazione. Questo blocco di dati privati è lo stesso dato specifico della risorsa passato nel membro pPrivateDriverData della struttura DXGKARG_CREATEALLOCATION nella chiamata alla funzione DxgkDdiCreateAllocation . Il driver miniport di visualizzazione non può modificare questo blocco di dati privati.

[in] PrivateDriverSize

Dimensioni, in byte, del blocco di dati privati a cui punta pPrivateDriverData .

[in] Flags

Struttura DXGK_OPENALLOCATIONFLAGS che identifica l'operazione da eseguire per le allocazioni.

[in] SubresourceIndex

Supportato a partire da Windows 8.

Indice nella risorsa per la superficie di destinazione di rendering.

Il sistema operativo specifica questo membro solo se il driver miniport di visualizzazione supporta l'accelerazione hardware GDI. In particolare, il driver miniport di visualizzazione deve implementare la funzione DxgkDdiRenderKm e deve creare il dispositivo con il membro GdiDevice impostato in DXGKARG_CREATEDEVICE. Flag.

Se il valore di SubresourceIndex è maggiore del numero di sottorisorse nell'allocazione, il driver miniport di visualizzazione deve restituire un errore.

[out] SubresourceOffset

Supportato a partire da Windows 8.

Offset, in byte, dall'inizio dell'allocazione all'inizio della sottorisorsa.

[out] Pitch

Supportato a partire da Windows 8.

Passo, in byte, dell'allocazione, ovvero la distanza, espressa in byte, all'inizio della riga successiva.