Metodo IStiDeviceControl::WriteToErrorLog (stiusd.h)

Il metodo IStiDeviceControl::WriteToErrorLog consente a un minidriver in modalità utente di scrivere un messaggio nel log degli errori dell'immagine ancora.

Sintassi

HRESULT WriteToErrorLog(
  DWORD   dwMessageType,
  LPCWSTR pszMessage,
  DWORD   dwErrorCode
);

Parametri

dwMessageType

Valore costante fornito dal chiamante che rappresenta il tipo di messaggio. I valori seguenti sono definiti in Sti.h:

STI_TRACE_INFORMATION

STI_TRACE_WARNING

STI_TRACE_ERROR

pszMessage

Puntatore fornito dal chiamante a una stringa di messaggio da scrivere nel file di log.

dwErrorCode

Non utilizzato.

Valore restituito

Se l'operazione ha esito positivo, il metodo restituisce S_OK. In caso contrario, restituisce uno dei codici di errore con prefisso STIERR definiti in stierr.h.

Commenti

Il file di log degli errori di immagine continua è denominato sti_trace.log e si trova nella directory di Windows. Pannello di controllo consente a un utente di selezionare i tipi di errore di immagine (informativo, avviso o errore) scritti nel log degli errori (vedere Voci del Registro di sistema non modificabili).

I messaggi di errore devono essere riservati per condizioni di errore critiche, ad esempio errori hardware del dispositivo. I messaggi informativi possono essere usati per scopi di debug personalizzati. I messaggi registrati non sono visibili agli utenti, ma possono essere usati da un tecnico del supporto tecnico per eseguire il debug dei problemi di un utente.

Un minidriver immagine riceve un puntatore all'interfaccia IStiDeviceControl come input per il metodo IStiUSD::Initialize .

Requisiti