Méthode IStiDeviceControl ::WriteToErrorLog (stiusd.h)

Article
02/29/2024

La méthode IStiDeviceControl ::WriteToErrorLog permet à un minidriver d’image fixe en mode utilisateur d’écrire un message dans le journal des erreurs d’image fixe.

Syntaxe

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

Paramètres

dwMessageType

Valeur constante fournie par l’appelant représentant le type de message. Les valeurs suivantes sont définies dans Sti.h :

STI_TRACE_INFORMATION

STI_TRACE_WARNING

STI_TRACE_ERROR

pszMessage

Pointeur fourni par l’appelant vers une chaîne de message à écrire dans le fichier journal.

dwErrorCode

Non utilisé.

Valeur retournée

Si l’opération réussit, la méthode retourne S_OK. Sinon, elle retourne l’un des codes d’erreur préfixés STIERR définis dans stierr.h.

Remarques

Le fichier journal des erreurs d’image fixe est nommé sti_trace.log et se trouve dans le répertoire Windows. Panneau de configuration permet à un utilisateur de sélectionner les types d’erreur d’image fixe (information, avertissement ou erreur) qui sont écrits dans le journal des erreurs (voir Entrées de Registre non modifiables).

Les messages d’erreur doivent être réservés aux conditions d’erreur critiques, telles que les défaillances matérielles de l’appareil. Les messages d’information peuvent être utilisés à vos propres fins de débogage. Les messages journalisés ne sont pas visibles par les utilisateurs, mais ils peuvent être utilisés par un ingénieur du support technique pour aider à déboguer les problèmes d’un utilisateur.

Un minidriver d’image fixe reçoit un pointeur d’interface IStiDeviceControl en entrée de sa méthode IStiUSD ::Initialize .

Configuration requise

Condition requise	Valeur
Plateforme cible	Desktop (Expérience utilisateur)
En-tête	stiusd.h (inclure Stiusd.h)

Partager via