DXGKDDI_RESETHWENGINE funzione di callback (d3dkmddi.h)
Dxgkrnl chiama la funzione DxgkDdiResetHwEngine del driver miniport di visualizzazione quando è necessaria una reimpostazione del motore GPU.
Sintassi
DXGKDDI_RESETHWENGINE DxgkddiResethwengine;
NTSTATUS DxgkddiResethwengine(
IN_CONST_HANDLE hAdapter,
INOUT_PDXGKARG_RESETHWENGINE pResetHwEngine
)
{...}
Parametri
hAdapter
[in] Handle per il 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 DxgkDdiAddDevice .
pResetHwEngine
[in/out] Puntatore a una struttura DXGKARG_RESETHWENGINE che contiene informazioni per reimpostare il motore hardware.
Valore restituito
DxgkDdiResetHwEngine restituisce STATUS_SUCCESS se l'operazione ha esito positivo. In caso contrario, deve restituire un codice di errore NTSTATUS appropriato.
Commenti
Un'implementazione dxgkDdiResetHwEngine deve chiamare il callback DxgkCbInvalidateHwContext per informare il sistema operativo di tutti i contesti in esecuzione interessati dall'operazione di reimpostazione del motore GPU. Il sistema operativo invaliderà questi dispositivi di contesto (impostati in caso di errore) e non eseguirà invii futuri.
Il motore non viene ancora considerato ripreso dopo la chiamata di DxgkDdiResetHwEngine , quindi i contesti che non sono stati invalidati non possono essere inviati. Il sistema operativo deve riabilitare gli interrupt da questo motore e sincronizzarne lo stato con il motore GPU di reimpostazione. Successivamente, il sistema operativo abiliterà le interruzioni e chiamerà DxgkDdiResumeHwEngine, che indica al motore GPU di avviare la pianificazione di tutti i contesti eseguibili che non sono stati interessati dalla reimpostazione del motore.
Registrare l'implementazione di questa funzione di callback nella struttura **DRIVER_INITIALIZATION_DATA ** .
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows 10 versione 1703 (WDDM 2.2) |
| Intestazione | d3dkmddi.h |