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.]
Observação
[Preterido. Essa API pode ser removida de versões futuras do Windows.]
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.
Observação
O arquivo de cabeçalho Qedit.h não é compatível com cabeçalhos Direct3D posteriores à versão 7.
Observação
Para obter qedit.h, baixe o SDK do Microsoft Windows Update para Windows Vista e .NET Framework 3.0. O Qedit.h não está disponível no SDK do Microsoft Windows para Windows 7 e .NET Framework 3.5 Service Pack 1.
Requisitos
| Requisito | Valor |
|---|---|
| parâmetro |
|
| Biblioteca |
|
Confira também