Metodo IStiDeviceControl::WriteToErrorLog (stiusd.h)

Articolo
02/07/2025

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

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 usato.

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.

Osservazioni

Il file di log degli errori dell'immagine ancora è denominato sti_trace.log e si trova nella directory di Windows. Il 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 potrebbero essere usati da un tecnico del supporto tecnico per facilitare il debug dei problemi di un utente.

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

Fabbisogno

Requisito	Valore
piattaforma di destinazione	Desktop
intestazione	stiusd.h (include Stiusd.h)

Condividi tramite