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 de memoria 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 de 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 miniporte 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 de.

Valor devuelto

Ninguno

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 miniporte 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 miniporte de vídeo registra la función HwVidBugcheckCallback llamando a la función videoPortRegisterBugcheckCallback. La función VideoPortRegisterBugcheckCallback expone esta devolución de llamada proporcionada por el controlador de miniport 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 miniporte 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 generado y no debe intentar acceder a datos o código paginable.

Requisitos

Requisito	Valor
de la plataforma de destino de	Escritorio
encabezado de	video.h (incluya Video.h)

Consulte también

VideoPortRegisterBugcheckCallback