struttura DXGKARGCB_CREATECONTEXTALLOCATION (d3dkmddi.h)

Articolo
03/08/2023

La struttura DXGKARGCB_CREATECONTEXTALLOCATION contiene gli attributi di allocazione di un contesto GPU o di un contesto specifico del dispositivo usato nella funzione di callback DXGKCB_CREATECONTEXTALLOCATION.

Sintassi

typedef struct _DXGKARGCB_CREATECONTEXTALLOCATION {
  [in]  DXGK_CREATECONTEXTALLOCATIONFLAGS ContextAllocationFlags;
  [in]  HANDLE                            hAdapter;
  [in]  HANDLE                            hDevice;
  [in]  HANDLE                            hContext;
  [in]  HANDLE                            hDriverAllocation;
  [in]  SIZE_T                            Size;
  [in]  UINT                              Alignment;
  [in]  UINT                              SupportedSegmentSet;
  [in]  UINT                              EvictionSegmentSet;
  [in]  DXGK_SEGMENTPREFERENCE            PreferredSegment;
  [in]  DXGK_SEGMENTBANKPREFERENCE        HintedBank;
  [in]  DXGK_ALLOCATIONINFOFLAGS          Flags;
  [out] HANDLE                            hAllocation;
  [in]  UINT                              PhysicalAdapterIndex;
} DXGKARGCB_CREATECONTEXTALLOCATION;

Members

[in] ContextAllocationFlags

Struttura DXGK_CREATECONTEXTALLOCATIONFLAGS che specifica le proprietà dell'allocazione.

[in] hAdapter

Handle per la scheda grafica per cui viene creata l'allocazione del contesto.

[in] hDevice

Handle per il dispositivo di visualizzazione passato originariamente dal sottosistema grafico DirectX alla funzione DxgkDdiCreateDevice del driver miniport di visualizzazione.

Nota

Questo membro è impostato su NULL per un dispositivo di sistema.

[in] hContext

Se ContextAllocationFlags.SharedAcrossContexts è impostato su un valore pari a 0, questo membro contiene il valore assegnato dal sottosistema grafico DirectX per il contesto passato alla funzione DXGKCB_CREATECONTEXTALLOCATION .

Se ContextAllocationFlags.SharedAcrossContexts è impostato su 1, questo membro deve essere impostato su NULL.

Nota

Questo membro è impostato anche su NULL per un contesto di sistema.

[in] hDriverAllocation

Handle creato dal driver miniport di visualizzazione che identifica l'allocazione creata. Il valore di questo membro viene successivamente passato come membro Transfer.hAllocation della struttura DXGKARG_BUILDPAGINGBUFFER a cui punta il parametro pBuildPagingBuffer della funzione DxgkDdiBuildPagingBuffer .

[in] Size

Dimensione, in byte, necessaria per l'allocazione.

[in] Alignment

Allineamento richiesto, in byte, per l'allocazione.

[in] SupportedSegmentSet

Identificatori di segmento che il driver miniport di visualizzazione può impostare nel membro PreferredSegment per le operazioni di lettura o scrittura.

[in] EvictionSegmentSet

Identificatori di segmenti che possono essere utilizzati per la rimozione.

[in] PreferredSegment

Struttura DXGK_SEGMENTPREFERENCE che indica gli identificatori di segmento preferiti che il driver miniport di visualizzazione richiede che la gestione memoria video usi per l'allocazione di pagine.

[in] HintedBank

Struttura DXGK_SEGMENTBANKPREFERENCE che indica le preferenze di ordinamento bancario richieste dal driver miniport di visualizzazione che il gestore memoria video utilizza per l'allocazione.

[in] Flags

Struttura DXGK_ALLOCATIONINFOFLAGS che identifica le proprietà per un'allocazione in flag di campo di bit. Queste proprietà indicano il tipo di allocazione da creare. Il driver miniport di visualizzazione specifica questi flag per la gestione della memoria video. Vedere La sezione Osservazioni per le restrizioni sui valori dei flag.

[out] hAllocation

Handle assegnato dal sottosistema grafico DirectX all'allocazione. Questo valore viene successivamente passato come parametro hAllocation della funzione DXGKCB_DESTROYCONTEXTALLOCATION .

[in] PhysicalAdapterIndex

Indice dell'adattatore fisico. Questo campo è disponibile a partire da WDDM 2.0.

Commenti

Il driver miniport di visualizzazione chiama DXGKCB_CREATECONTEXTALLOCATION per allocare un contesto GPU o un contesto specifico del dispositivo. Quando il driver chiama questa funzione, passa un puntatore a una struttura DXGKARGCB_CREATECONTEXTALLOCATION tramite il parametro ContextAllocation .