Metodo IStiDeviceControl::WriteToErrorLog (stiusd.h)

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

Sintassi

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

Parametri

dwMessageType

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

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 dell'immagine ancora è denominato sti_trace.log e si trova nella directory Windows. Pannello di controllo consente a un utente di selezionare quali tipi di errore dell'immagine (informativo, di avviso o di errore) vengono 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 per facilitare il debug dei problemi di un utente.

Un minidriver di immagini ancora riceve un puntatore a interfaccia IStiDeviceControl come input per il relativo metodo IStiUSD::Initialize .

Requisiti

   
Piattaforma di destinazione Desktop
Intestazione stiusd.h (includere Stiusd.h)