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 |