DXGKDDI_GETSTANDARDALLOCATIONDRIVERDATA funzione di callback (d3dkmddi.h)

Articolo
02/23/2024

La funzione DxgkDdiGetStandardAllocationDriverData restituisce una descrizione di un tipo di allocazione standard.

Sintassi

DXGKDDI_GETSTANDARDALLOCATIONDRIVERDATA DxgkddiGetstandardallocationdriverdata;

NTSTATUS DxgkddiGetstandardallocationdriverdata(
  [in]     IN_CONST_HANDLE hAdapter,
  [in/out] INOUT_PDXGKARG_GETSTANDARDALLOCATIONDRIVERDATA pGetStandardAllocationDriverData
)
{...}

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 della grafica Microsoft DirectX nel parametro di output MiniportDeviceContext della funzione DxgkDdiAddDevice .

[in/out] pGetStandardAllocationDriverData

Puntatore a una struttura DXGKARG_GETSTANDARDALLOCATIONDRIVERDATA che descrive un'allocazione standard.

Valore restituito

DxgkDdiGetStandardAllocationDriverData restituisce uno dei valori seguenti:

Codice restituito	Descrizione
STATUS_SUCCESS	DxgkDdiGetStandardAllocationDriverData ha restituito correttamente una descrizione del tipo di allocazione standard.
STATUS_NO_MEMORY	DxgkDdiGetStandardAllocationDriverData non è riuscito ad allocare memoria necessaria per il completamento.

Commenti

I tipi di allocazione standard sono allocazioni che devono essere create in modalità kernel senza comunicazioni dal driver di visualizzazione in modalità utente. Il sottosistema kernel della grafica DirectX chiama la funzione DxgkDdiGetStandardAllocationDriverData per generare una descrizione del tipo di allocazione standard specificato dal parametro pGetStandardAllocationDriverData . Il driver miniport di visualizzazione restituisce la descrizione del tipo di allocazione nei membri pAllocationPrivateDriverData e pResourcePrivateDriverData della struttura DXGKARG_GETSTANDARDALLOCATIONDRIVERDATA a cui punta il parametro pGetStandardAllocationDriverData . Il sottosistema kernel grafico DirectX passa successivamente la descrizione alla funzione DxgkDdiCreateAllocation per creare effettivamente l'allocazione.

A partire da Windows 7, se un driver miniport visualizzato elabora una chiamata alla funzione DxgkDdiGetStandardAllocationDriverData per creare allocazioni per l'accelerazione hardware GDI, il driver deve impostare l'inclinazione dell'allocazione per le allocazioni visibili della CPU, pGetStandardAllocationDriverData-pCreateGdiSurfaceData-Pitch>>.

DxgkDdiGetStandardAllocationDriverData deve essere reso pageable.