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

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 nunca alcanzó 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 de tiempo de espera (TDR).

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 gráfico de DirectX en la función MiniportDeviceContext parámetro de salida del DxgkDdiAddDevice función.

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 en su lugar el controlador devuelve 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 siguiente sección Comentarios.

Observaciones

Nota El subsistema del kernel de gráficos directX llama a esta función solo si el DXGK_VIDSCHCAPS.se establece el miembro CancelCommandAware.

 

Si el controlador devuelve un código de error, el subsistema del kernel de gráficos directX hace que se produzca una comprobación de errores del sistema. En un archivo de volcado de memoria, el mensaje BugCheck 0x119, 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	Valor
cliente mínimo admitido	Windows 8
servidor mínimo admitido	Windows Server 2012
de la plataforma de destino de	Escritorio
encabezado de	d3dkmddi.h
irQL	PASSIVE_LEVEL

Consulte también

DXGKARG_CANCELCOMMAND

DXGK_VIDSCHCAPS

dxgkDdiAddDevice