Función VideoPortRegisterBugcheckCallback (video.h)
La función VideoPortRegisterBugcheckCall back 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 HwVidBugcheckCall back del controlador de miniporte. Esta función debe no paginarse y no debe hacer referencia a datos o 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 desengancarse.
[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 miniport puede establecer este parámetro en cero para indicar que la devolución de llamada de comprobación de errores debe estar desenganchada.
Valor devuelto
videoPortRegisterBugcheckCallback devuelve NO_ERROR si se ejecuta correctamente. De lo contrario, devuelve un código de estado que indica la naturaleza del error.
Observaciones
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 VideoPortGetProcAddress rutina de devolución de llamada para encontrar la dirección de la función VideoPortRegisterBugcheckCallback. Para obtener más información, consulte Using VideoPortGetProcAddress.
Un controlador de miniport 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 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 el minidriver y el controlador de miniporte puede anexar datos al archivo de volcado de memoria. Esto resulta ú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 miniport. Por ejemplo, supongamos que el controlador de miniporte 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 miniport puede anular el registro de una devolución de llamada registrada previamente mediante una llamada 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 | Valor |
|---|---|
| cliente mínimo admitido | Disponible en Windows XP SP1 y versiones posteriores de los sistemas operativos Windows. |
| de la plataforma de destino de | Escritorio |
| encabezado de | video.h (incluya Video.h) |
| biblioteca de | Videoprt.lib |
| DLL de | Videoprt.sys |
| irQL | PASSIVE_LEVEL |