Método IAMErrorLog::LogError

[O recurso associado a esta página, DirectShow, é um recurso herdado. Foi substituído por MediaPlayer, IMFMediaEngine e Audio/Video Capture in Media Foundation. Esses recursos foram otimizados para Windows 10 e Windows 11. A Microsoft recomenda fortemente que o novo código use MediaPlayer, IMFMediaEngine e Audio/Video Capture in Media Foundation em vez de DirectShow, quando possível. A Microsoft sugere que o código existente que usa as APIs herdadas seja reescrito para usar as novas APIs, se possível.]

O método LogError registra um erro. Os aplicativos não precisam chamar esse método. Ele é chamado internamente em resposta a erros de renderização.

Sintaxe

HRESULT LogError(
       LONG    Severity,
       BSTR    ErrorString,
       LONG    ErrorCode,
       HRESULT hresult,
  [in] VARIANT *pExtraInfo
);

Parâmetros

Gravidade

Reservado. Não use.

ErrorString

Valor da cadeia de caracteres que contém o texto do erro.

ErrorCode

Código do erro.

hresult

O valor HRESULT que foi retornado pela chamada de método que causou o erro.

pExtraInfo [in]

Ponteiro para um VARIANT que contém informações adicionais sobre o erro.

Retornar valor

Retornar o valor do parâmetro hresult .

Comentários

Dentro desse método, não libere a VARIANT apontada por pExtraInfo. Além disso , variant torna-se inválido depois que o método retorna, portanto, não tente referenciá-lo mais tarde.

Implemente esse método para retornar o mais rápido possível. Não faça chamadas de função de dentro desse método que possam bloquear a execução do programa. Por exemplo, não chame funções que enviam mensagens de janela, bloqueiam eventos ou, caso contrário, podem bloquear a execução. Isso pode fazer com que o computador pare de responder.

Para obter uma lista de erros definidos pelo DES, juntamente com o significado e o tipo de dados da VARIANT apontada por pExtraInfo, consulte Erros de renderização.

Requisitos

Confira também

IAMErrorLog Interface

Códigos de erro e êxito