PVIDEO_BUGCHECK_CALLBACK funzione di callback (video.h)
La funzione HwVidBugcheckCallback consente al driver miniport di aggiungere dati a un file di dump quando si verifica un controllo di bug.
Sintassi
PVIDEO_BUGCHECK_CALLBACK PvideoBugcheckCallback;
void PvideoBugcheckCallback(
[in] IN PVOID HwDeviceExtension,
[in] IN ULONG BugcheckCode,
[in] IN PUCHAR Buffer,
[in] IN ULONG BufferSize
)
{...}
Parametri
[in] HwDeviceExtension
Puntatore all'area di archiviazione per scheda del driver miniport. Per altre informazioni, vedere Estensioni del dispositivo.
[in] BugcheckCode
Specifica un codice di controllo dei bug.
[in] Buffer
Puntatore alla posizione di memoria in cui il driver miniport può archiviare i dati da aggiungere al file di dump.
[in] BufferSize
Specifica le dimensioni, in byte, del buffer a cui punta il parametro Buffer .
Valore restituito
nessuno
Osservazioni
Questa funzione è disponibile in Windows XP SP1 e versioni successive.
Questa funzione viene chiamata quando si verifica un controllo di bug. Il driver miniport può raccogliere dati da aggiungere al file di dump e scrivere questi dati nel buffer. Il driver non deve scrivere più di bufferSize byte nel buffer.
Un driver miniport video registra la funzione HwVidBugcheckCallback chiamando la funzione VideoPortRegisterBugcheckCallback . La funzione VideoPortRegisterBugcheckCallback espone questo callback fornito dal driver video miniport al sistema.
Per facilitare il ripristino del sistema dopo un controllo di bug, tutti i registri a cui si accede da questa funzione non devono impedire la capacità dell'hardware di trasferire in modalità di fallback, indipendentemente dallo stato del dispositivo. Inoltre, la funzione deve restituire il controllo al chiamante.
Poiché un sistema può essere costituito da più driver miniport video, i fornitori devono aggiungere una stringa di identificazione ai dati che questa funzione aggiunge al file dump.
La funzione viene chiamata in irQL generato e non deve tentare di accedere a codice o dati di paging.
Requisiti
| Requisito | Valore |
|---|---|
| Piattaforma di destinazione | Desktop |
| Intestazione | video.h (include Video.h) |