DXGKDDI_GETSTANDARDALLOCATIONDRIVERDATA funzione di callback (d3dkmddi.h)

Articolo
11/11/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 di visualizzazione in modalità kernel (KMD) precedentemente ha fornito questo handle per Dxgkrnl nella relativa funzione DxgkDdiAddDevice.

[in/out] pGetStandardAllocationDriverData

Puntatore a una strutturaDXGKARG_GETSTANDARDALLOCATIONDRIVERDATA che descrive un'allocazione standard.

Valore restituito

DxgkDdiGetStandardAllocationDriverData restituisce uno dei valori seguenti:

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

Osservazioni

tipi di allocazione Standard sono allocazioni che devono essere create in modalità kernel senza comunicazione dal driver di visualizzazione in modalità utente.

Dxgkrnl chiama il driver in modalità kernel (KMD) DxgkDdiGetStandardAllocationDriverData funzione per generare una descrizione del tipo di allocazione standard specificato dal parametro pGetStandardAllocationDriverData. KmD restituisce la descrizione del tipo di allocazione nel pAllocationPrivateDriverData e pResourcePrivateDriverData membri della struttura DXGKARG_GETSTANDARDALLOCATIONDRIVERDATA a cui punta il parametro pGetStandardAllocationDriver Data. Dxgkrnl successivamente passa la descrizione alla funzione DxgkDdiCreateAllocation per creare effettivamente l'allocazione.

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

il DxgkDdiGetStandardAllocationDriverData deve essere reso pageable.