PVIDEO_BUGCHECK_CALLBACK función de devolución de llamada (video.h)

La función HwVidBugcheckCallback permite al controlador de miniportar anexar datos a un archivo de volcado cuando se produce una comprobación de errores.

Sintaxis

PVIDEO_BUGCHECK_CALLBACK PvideoBugcheckCallback;

void PvideoBugcheckCallback(
  [in] IN PVOID HwDeviceExtension,
  [in] IN ULONG BugcheckCode,
  [in] IN PUCHAR Buffer,
  [in] IN ULONG BufferSize
)
{...}

Parámetros

[in] HwDeviceExtension

Puntero al área de almacenamiento por adaptador del controlador miniporte. Para obtener más información, consulte Extensiones de dispositivo.

[in] BugcheckCode

Especifica un código de comprobación de errores.

[in] Buffer

Puntero a la ubicación de memoria donde el controlador de minipuerto puede almacenar los datos que se van a anexar al archivo de volcado.

[in] BufferSize

Especifica el tamaño, en bytes, del búfer al que apunta el parámetro Buffer .

Valor devuelto

None

Observaciones

Esta función está disponible en Windows XP SP1 y versiones posteriores.

Se llama a esta función cuando se produce una comprobación de errores. El controlador de minipuerto puede recopilar datos que se van a anexar al archivo de volcado y escribir estos datos en el búfer. El controlador no debe escribir más de BufferSize bytes en el búfer.

Un controlador de minipuerto de vídeo registra la función HwVidBugcheckCallback mediante una llamada a la función VideoPortRegisterBugcheckCallback . La función VideoPortRegisterBugcheckCallback expone esta devolución de llamada proporcionada por el controlador de minipuerto de vídeo al sistema.

Para facilitar la recuperación del sistema después de una comprobación de errores, los registros a los que accede esta función no deben impedir la capacidad del hardware de transferir al modo de reserva, independientemente del estado del dispositivo. Además, la función debe devolver el control a su llamador.

Dado que un sistema puede constar de varios controladores de minipuerto de vídeo, los proveedores deben agregar una cadena de identificación a los datos que esta función anexa al archivo de volcado de memoria.

Se llama a la función en IRQL elevado y no debe intentar acceder al código paginable ni a los datos.

Requisitos

Consulte también

VideoPortRegisterBugcheckCallback