DXGKDDI_DESCRIBEALLOCATION funzione di callback (d3dkmddi.h)

Articolo
02/23/2024

La funzione DxgkDdiDescribeAllocation recupera informazioni su un'allocazione esistente che non è altrimenti disponibile per il sottosistema kernel di grafica Microsoft DirectX.

Sintassi

DXGKDDI_DESCRIBEALLOCATION DxgkddiDescribeallocation;

NTSTATUS DxgkddiDescribeallocation(
  [in]     IN_CONST_HANDLE hAdapter,
  [in/out] INOUT_PDXGKARG_DESCRIBEALLOCATION pDescribeAllocation
)
{...}

Parametri

[in] hAdapter

Handle di un blocco di contesto associato a una scheda di visualizzazione. Il driver miniport di visualizzazione fornito in precedenza questo handle al sottosistema kernel grafico DirectX nel parametro di output MiniportDeviceContext della funzione DxgkDdiAddDevice .

[in/out] pDescribeAllocation

Puntatore a una struttura DXGKARG_DESCRIBEALLOCATION che descrive un'allocazione esistente.

Valore restituito

DxgkDdiDescribeAllocation restituisce STATUS_SUCCESS se ha esito positivo; in caso contrario, restituisce uno dei codici di errore definiti in Ntstatus.h.

Commenti

Poiché il sottosistema kernel grafico DirectX non mantiene necessariamente i record di allocazioni, il sottosistema kernel grafico chiama DxgkDdiDescribeAllocation per richiedere che il driver miniport di visualizzazione restituisca informazioni sulle allocazioni esistenti. Attualmente, il driver miniport di visualizzazione deve essere in grado di restituire queste informazioni per le allocazioni seguenti:

Allocazioni che sono anche primarie, ovvero allocazioni create dal driver di visualizzazione in modalità utente impostando il flag Campo di bit primario nel membro Flags della struttura D3DDDI_ALLOCATIONINFO in una chiamata alla funzione pfnAllocateCb .
Allocazioni che potrebbero essere l'origine di una presentazione , ovvero allocazioni rappresentate dal membro hSource della struttura DXGKARG_PRESENT in una chiamata alla funzione DxgkDdiPresent del driver miniport di visualizzazione.

DxgkDdiDescribeAllocation deve essere reso impaginabile.