DXGKDDI_QUERYDIRTYBITDATA funzione di callback (d3dkmddi.h)

Dxgkrnl chiama DxgkDdiQueryDirtyBitData per richiedere una copia dei dati bitplane dirty dal driver miniport (KMD) in modalità kernel.

Sintassi

DXGKDDI_QUERYDIRTYBITDATA DxgkddiQuerydirtybitdata;

NTSTATUS DxgkddiQuerydirtybitdata(
  IN_CONST_HANDLE hAdapter,
  INOUT_PDXGKARG_QUERYDIRTYBITDATA pArgs
)
{...}

Parametri

hAdapter

[in] Handle di un blocco di contesto associato a una scheda di visualizzazione. KmD ha fornito in precedenza questo handle a Dxgkrnl nel parametro di output MiniportDeviceContext della funzione DxgiDdiAddDevice .

pArgs

[in/out] Puntatore a una struttura DXGKARG_QUERYDIRTYBITDATA che contiene informazioni di input e output per la query.

Valore restituito

DxgkDdiQueryDirtyBitData restituisce STATUS_SUCCESS se la query è stata eseguita correttamente. In caso contrario, restituisce un codice di errore NTSTATUS appropriato.

Commenti

La funzione fornisce la base di memoria e i potenziali identificatori di intervallo secondario per le informazioni dirty richieste. Il kmD deve scrivere i dati risultanti nel buffer di output. DxgkDdiQueryDirtyBitData consente di eseguire query su tutti gli intervalli della base di memoria o su un singolo intervallo.

Quando la memoria è prontamente disponibile, Dxgkrnl tenterà di accelerare questa operazione usando una singola chiamata per eseguire una query su tutti i dati necessari contemporaneamente. Tuttavia, in condizioni di memoria insufficiente, l'avanzamento avanti usando un buffer di dimensioni fisse più piccole potrebbe essere necessario, che è solo un subset più piccolo della base di memoria monitorata da una chiamata precedente a DdiStartDirtyTracking. L'intervallo bitplane dirty richiesto non supererà mai un intervallo dirty monitorato attivamente.

Per altre informazioni, vedere Rilevamento bit dirty.

Requisiti

Vedi anche

DXGKARG_QUERYDIRTYBITDATA