DXGKDDI_RESETHWENGINE función de devolución de llamada (d3dkmddi.h)

Dxgkrnl llama a la función DxgkDdiResetHwEngine 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ó previamente este identificador a Dxgkrnl en el parámetro de salida MiniportDeviceContext de la función DxgkDdiAddDevice .

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.

Comentarios

Una implementación de DxgkDdiResetHwEngine debe llamar a la devolución de llamada DxgkCbInvalidateHwContext 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 llamar a DxgkDdiResetHwEngine , por lo que no se permiten enviar contextos que no se invalidaron. 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, 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 **DRIVER_INITIALIZATION_DATA ** .

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 10, versión 1703 (WDDM 2.2)
Encabezado	d3dkmddi.h

Consulte también

DXGKARG_RESETHWENGINE

DxgkDdiResumeHwEngine