DXGKCB_INVALIDATEHWCONTEXT función de devolución de llamada (d3dkmddi.h)
Un controlador de gráficos en modo kernel (KMD) llama a DxgkcbInvalidatehwcontext para invalidar un contexto de hardware.
Sintaxis
DXGKCB_INVALIDATEHWCONTEXT DxgkcbInvalidatehwcontext;
NTSTATUS DxgkcbInvalidatehwcontext(
[in] IN_CONST_PDXGKARGCB_INVALIDATEHWCONTEXT unnamedParam1
)
{...}
Parámetros
[in] unnamedParam1
Puntero a una estructura de DXGKARGCB_INVALIDATEHWCONTEXT que contiene información para dxgkrnl usar para invalidar el contexto de hardware.
Valor devuelto
dxgkcbInvalidatehwcontext devuelve STATUS_SUCCESS si la operación se realiza correctamente. De lo contrario, devuelve un código de error NTSTATUS adecuado.
Observaciones
KMD llama a DxgkcbInvalidatehwcontext para notificar al sistema cuándo el estado y los recursos asociados a un contexto de hardware ya no son válidos o coherentes, lo que requiere que el contexto se restablezca o reinicialice antes de poder volver a usarse. Es necesario invalidar un contexto en caso de que se produzca una operación de restablecimiento del motor de hardware que pueda deberse a diversos motivos, como la recuperación de un error o reconfiguración de los recursos de GPU.
Dxgkrnl marca el contexto como no válido para que ya no esté programado para su ejecución en la GPU. A continuación, inicia cualquier limpieza necesaria, como liberar recursos asociados al contexto o restablecer cualquier estado asociado al contexto.
DXGKCB_XXX funciones se implementan mediante Dxgkrnl. Para usar esta función de devolución de llamada, establezca los miembros de DXGKARGCB_INVALIDATEHWCONTEXT y llame a DxgkCbInvalidateHwContext a través del DXGKRNL_INTERFACE.
Requisitos
| Requisito | Valor |
|---|---|
| cliente mínimo admitido | Windows 10, versión 1703 (WDDM 2.2) |
| encabezado de | d3dkmddi.h |
| irQL | PASSIVE_LEVEL |