Función VideoPortRegisterBugcheckCallback (video.h)
La función VideoPortRegisterBugcheckCallback permite que un controlador de miniporte de vídeo se registre o enlace, una devolución de llamada que se invoca cuando se produce una comprobación de errores especificada.
Sintaxis
VIDEOPORT_DEPRECATED VIDEOPORT_API VP_STATUS VideoPortRegisterBugcheckCallback(
[in] IN PVOID HwDeviceExtension,
[in] IN ULONG BugcheckCode,
[in] IN PVIDEO_BUGCHECK_CALLBACK Callback,
[in] IN ULONG BugcheckDataSize
);
Parámetros
[in] HwDeviceExtension
Puntero a la extensión del dispositivo del controlador de minipuerto.
[in] BugcheckCode
Indica el código de comprobación de errores para el que se va a llamar. Actualmente, el controlador de minipuerto solo puede registrarse para comprobar el código de comprobación de errores 0xEA.
[in] Callback
Puntero a la función HwVidBugcheckCallback del controlador de miniporte. Esta función debe ser no paginada y no debe hacer referencia a datos ni código paginable. El controlador de minipuerto puede establecer este parámetro en NULL para indicar que la devolución de llamada de comprobación de errores debe desengancharse.
[in] BugcheckDataSize
Indica la suma de BUGCHECK_DATA_SIZE_RESERVED y el número de bytes de datos que proporcionará el controlador de miniporte para su inclusión en el archivo de volcado. El valor de este parámetro debe ser menor o igual que 4000. El controlador de minipuerto puede establecer este parámetro en cero para indicar que la devolución de llamada de comprobación de errores se debe desenganchar.
Valor devuelto
VideoPortRegisterBugcheckCallback devuelve NO_ERROR si se realiza correctamente. De lo contrario, devuelve un código de estado que indica la naturaleza del error.
Comentarios
Si está desarrollando un controlador de miniporte de vídeo destinado a ejecutarse en Windows XP o en un sistema operativo nt-base anterior, puede usar la rutina de devolución de llamada VideoPortGetProcAddress para encontrar la dirección de la función VideoPortRegisterBugcheckCallback . Para obtener más información, consulte Uso de VideoPortGetProcAddress.
Un controlador de minipuerto puede registrarse para una devolución de llamada cuando se produce un tipo específico de comprobación de errores. Actualmente, solo se puede enlazar el código de comprobación de errores 0xEA . Cuando se produce la comprobación de errores, se llama a la función de devolución de llamada proporcionada por minidriver y el controlador de miniporte puede anexar datos al archivo de volcado. Esto es útil para recopilar datos estadísticos cuando no es posible la depuración directa.
El valor del parámetro BugcheckDataSize debe ser BUGCHECK_DATA_SIZE_RESERVED bytes mayores que los datos proporcionados por el controlador de minipuerto. Por ejemplo, supongamos que el controlador de minipuerto proporciona DUMP_SIZE bytes de datos que se van a escribir en el archivo de volcado de memoria. A continuación, el valor de BugcheckDataSize debe ser DUMP_SIZE + BUGCHECK_DATA_SIZE_RESERVED y ese valor total debe ser menor o igual que 4000.
La constante BUGCHECK_DATA_SIZE_RESERVED (definida en video.h) está disponible en Los entornos de compilación de Microsoft Windows Server 2003 y versiones posteriores. En el entorno de compilación de Windows XP SP1, use 48 en lugar de BUGCHECK_DATA_SIZE_RESERVED.
El controlador de minipuerto puede anular el registro de una devolución de llamada registrada previamente llamando a esta función, especificando NULL para el parámetro Callback o cero para el parámetro DataSize .
Para obtener más información, consulte Compatibilidad del controlador de puerto de vídeo para las devoluciones de llamada de comprobación de errores.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Disponible en Windows XP SP1 y versiones posteriores de los sistemas operativos Windows. |
| Plataforma de destino | Escritorio |
| Encabezado | video.h (incluya Video.h) |
| Library | Videoprt.lib |
| Archivo DLL | Videoprt.sys |
| IRQL | PASSIVE_LEVEL |