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)

Vedi anche

VideoPortRegisterBugcheckCallback