DXGKDDI_QUERYDIRTYBITDATA funzione di callback (d3dkmddi.h)
Dxgkrnl chiama DxgkDdiQueryDirtyBitData per richiedere una copia dei dati bitplane dirty dal driver miniport di visualizzazione in modalità kernel (KMD).
Sintassi
DXGKDDI_QUERYDIRTYBITDATA DxgkddiQuerydirtybitdata;
NTSTATUS DxgkddiQuerydirtybitdata(
IN_CONST_HANDLE hAdapter,
INOUT_PDXGKARG_QUERYDIRTYBITDATA pArgs
)
{...}
Parametri
hAdapter
[in] Handle per un blocco di contesto associato a una scheda di visualizzazione. KmD in precedenza forniva questo handle per Dxgkrnl nella MiniportDeviceContext parametro di output 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.
Osservazioni
La funzione fornisce la base di memoria e gli identificatori potenziali di intervalli secondari 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, è possibile che sia necessario inoltrare lo stato di avanzamento usando un buffer con dimensioni fisse più piccole, che è solo un subset più piccolo della base di memoria monitorata da una chiamata precedente a DdiStartDirtyTracking. L'intervallo bitplane sporco richiesto non supererà mai un intervallo dirty monitorato attivamente.
Per altre informazioni, vedere Rilevamento bit dirty.
Fabbisogno
| Requisito | Valore |
|---|---|
| client minimo supportato | Windows 11, versione 24H2 (WDDM 3.2) |
| intestazione | d3dkmddi.h |
| IRQL | PASSIVE_LEVEL |