DXGKDDI_RESETHWENGINE función de devolución de llamada (d3dkmddi.h)
Dxgkrnl llama a la función de DxgkDdiResetHw Engine del controlador de miniporte de pantalla cuando se requiere un restablecimiento del motor de GPU.
Sintaxis
DXGKDDI_RESETHWENGINE DxgkddiResethwengine;
NTSTATUS DxgkddiResethwengine(
IN_CONST_HANDLE hAdapter,
INOUT_PDXGKARG_RESETHWENGINE pResetHwEngine
)
{...}
Parámetros
hAdapter
[in] Identificador del bloque de contexto asociado a un adaptador de pantalla. KMD proporcionó anteriormente este identificador para Dxgkrnl en la funciónMiniportDeviceContext parámetro de salida delDxgkDdiAddDevice.
pResetHwEngine
[in/out] Puntero a una estructura de DXGKARG_RESETHWENGINE que contiene información para restablecer el motor de hardware.
Valor devuelto
dxgkDdiResetHwEngine devuelve STATUS_SUCCESS si la operación se realiza correctamente. De lo contrario, debe devolver un código de error NTSTATUS adecuado.
Observaciones
Una implementación de DxgkDdiResetHwEngine debe llamar a la DxgkCbInvalidateHwContext devolución de llamada para informar al sistema operativo de todos los contextos en ejecución afectados por la operación de restablecimiento del motor de GPU. El sistema operativo invalidará estos dispositivos de contexto (los establecerá en error) y no realizará envíos futuros.
El motor aún no se considera reanudado después de que se llame a dxgkDdiResetHwEngine, por lo que los contextos que no se invalidaron no pueden enviarse. El sistema operativo debe volver a habilitar las interrupciones de este motor y sincronizar su estado con el motor de restablecimiento de GPU. Después, el sistema operativo habilitará las interrupciones y llamará a DxgkDdiResumeHwEngine, lo que indica al motor de GPU que empiece a programar todos los contextos ejecutables que no se vieron afectados por el restablecimiento del motor.
Registre la implementación de esta función de devolución de llamada en la estructura de **DRIVER_INITIALIZATION_DATA **.
Requisitos
| Requisito | Valor |
|---|---|
| cliente mínimo admitido | Windows 10, versión 1703 (WDDM 2.2) |
| encabezado de | d3dkmddi.h |