struttura DXGKARG_OPENALLOCATION (d3dkmddi.h)

Articolo
02/06/2025

La struttura DXGKARG_OPENALLOCATION descrive le allocazioni che il driver di 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;

Membri

[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 di 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 è costituito dagli stessi dati specifici della risorsa passati 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 pPrivateDriverData punta.

[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 accelerazione hardware GDI. In particolare, il driver del miniport di visualizzazione deve implementare la funzione dxgkDdiRenderKm e deve creare il dispositivo con il GdiDevice membro 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, in byte, all'inizio della riga successiva.