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

O método IStiDeviceControl::WriteToErrorLog permite que um minidriver de imagem ainda no modo de usuário escreva uma mensagem no log de erros de imagem ainda.

Sintaxe

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

Parâmetros

dwMessageType

Valor constante fornecido pelo chamador que representa o tipo de mensagem. Os seguintes valores são definidos em Sti.h:

STI_TRACE_INFORMATION

STI_TRACE_WARNING

STI_TRACE_ERROR

pszMessage

Ponteiro fornecido pelo chamador para uma cadeia de caracteres de mensagem a ser gravada no arquivo de log.

dwErrorCode

Não usado.

Retornar valor

Se a operação for bem-sucedida, o método retornará S_OK. Caso contrário, ele retornará um dos códigos de erro prefixados por STIERR definidos em stierr.h.

Comentários

O arquivo de log de erros de imagem está nomeado sti_trace.log e está localizado no diretório do Windows. Painel de Controle permite que um usuário selecione quais tipos de erro de imagem ainda (informativo, aviso ou erro) são gravados no log de erros (consulte Entradas do Registro não modificáveis).

As mensagens de erro devem ser reservadas para condições críticas de erro, como falhas de hardware do dispositivo. Mensagens informativas podem ser usadas para suas próprias finalidades de depuração. As mensagens registradas não são visíveis para os usuários, mas podem ser usadas por um engenheiro de suporte para ajudar a depurar os problemas de um usuário.

Um minidriver de imagem ainda recebe um ponteiro de interface IStiDeviceControl como entrada para seu método IStiUSD::Initialize .

Requisitos