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

  • Artículo

Limpia los recursos internos asociados a un paquete de acceso directo a memoria (DMA) que estaba en la cola de software del programador de GPU, pero que nunca llegó a la cola de hardware porque el dispositivo entró en un estado de error. Este estado de error suele deberse a un evento de detección y recuperación (TDR) de tiempo de espera .

Sintaxis

DXGKDDI_CANCELCOMMAND DxgkddiCancelcommand;

NTSTATUS DxgkddiCancelcommand(
  IN_CONST_HANDLE hAdapter,
  IN_CONST_PDXGKARG_CANCELCOMMAND pCancelCommand
)
{...}

Parámetros

hAdapter

Identificador de un bloque de contexto asociado a un adaptador de pantalla. El controlador de minipuerto de pantalla proporcionó anteriormente este identificador al subsistema del kernel de gráficos directX en el parámetro de salida MiniportDeviceContext de la función DxgkDdiAddDevice .

pCancelCommand

Puntero a una estructura de DXGKARG_CANCELCOMMAND que especifica los recursos que se van a limpiar después de quitar un comando de la cola de hardware.

Valor devuelto

Devuelve STATUS_SUCCESS tras la finalización correcta. Si el controlador devuelve en su lugar un código de error, el sistema operativo hace que se produzca una comprobación de errores del sistema. Para obtener más información, vea la sección Comentarios que se muestra más adelante.

Comentarios

Nota El subsistema del kernel de gráficos de DirectX solo llama a esta función si el DXGK_VIDSCHCAPS. Se ha establecido el miembro CancelCommandAware .
 
Si el controlador devuelve un código de error, el subsistema del kernel de gráficos de DirectX hace que se produzca una comprobación de errores del sistema. En un archivo de volcado de memoria, el mensaje BugCheck 0x119 indica el error, que tiene los cuatro parámetros siguientes.
  1. 0x9
  2. El código de error NTSTATUS devuelto desde la llamada al controlador con errores
  3. Puntero a la estructura DXGKARG_CANCELCOMMAND
  4. Puntero a una estructura de datos de programador interna

Requisitos

Requisito Value
Cliente mínimo compatible Windows 8
Servidor mínimo compatible Windows Server 2012
Plataforma de destino Escritorio
Encabezado d3dkmddi.h
IRQL PASSIVE_LEVEL

Consulte también

DXGKARG_CANCELCOMMAND

DXGK_VIDSCHCAPS

DxgkDdiAddDevice