Funzione VideoPortLogError (video.h)

La funzione VideoPortLogError registra gli errori nel registro eventi di sistema quando un driver miniport rileva una condizione di errore hardware durante le operazioni di I/O.

Sintassi

VIDEOPORT_API VOID VideoPortLogError(
  PVOID                 HwDeviceExtension,
  PVIDEO_REQUEST_PACKET Vrp,
  VP_STATUS             ErrorCode,
  ULONG                 UniqueId
);

Parametri

HwDeviceExtension

Puntatore all'estensione del dispositivo del driver miniport.

Vrp

[facoltativo] Puntatore a una struttura [VIDEO_REQUEST_PACKET] che descrive il pacchetto di richiesta video (VRP) se uno è associato all'errore; altrimenti NULL.

ErrorCode

Specifica un codice di errore definito dal driver miniport che indica il tipo di errore hardware.

UniqueId

Specifica un identificatore univoco per l'errore. Questo valore differenzia l'errore corrente da altri errori con lo stesso ErrorCode. Per alcuni driver miniport, questo identifica la riga di codice in cui è stato rilevato l'errore; per altri, è un valore restituito dall'hardware.

Valore restituito

nessuno

Osservazioni

I driver Miniport devono chiamare VideoPortLogError per notificare all'utente se il driver rileva errori hardware insoliti durante le normali operazioni. La registrazione di tali errori nel registro eventi di sistema avvisa l'utente che la scheda video potrebbe non riuscire in modo che l'utente possa sostituire (o riconfigurare) la scheda prima che si verifichi un errore hardware totale.

Tuttavia, i driver miniport non devono registrare errori, ad esempio "non è stato possibile rilevare l'hardware", che si verificano spesso durante la normale operazione.

VideoPortLogError può essere chiamato dalla funzione HwVidInterrupt o HwVidSynchronizeExecutionCallback di un driver miniport.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000
Piattaforma di destinazione	Desktop
Intestazione	video.h (includere Video.h)
Libreria	Videoprt.lib
DLL	Videoprt.sys
IRQL	<= DIRQL

Vedi anche

VideoDebugPrint