Função AMGetErrorTextA (errors.h)

  • Artigo

[O recurso associado a esta página, DirectShow, é um recurso herdado. Ele foi substituído por MediaPlayer, IMFMediaEngine e Captura de Áudio/Vídeo na 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 Captura de Áudio/Vídeo no 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.]

A função AMGetErrorText recupera a mensagem de erro de um determinado código de retorno, usando a configuração de idioma atual.

Essa função converte códigos de retorno HRESULT em mensagens de erro. A constante MAX_ERROR_TEXT_LEN especifica o número máximo de caracteres em uma mensagem de erro.

Sintaxe

AMOVIEAPI DWORD AMGetErrorTextA(
  HRESULT hr,
  LPSTR   pbuffer,
  DWORD   MaxLen
);

Parâmetros

hr

Valor HRESULT .

pbuffer

Ponteiro para um buffer de caracteres que recebe a mensagem de erro.

MaxLen

Número de caracteres no pBuffer.

Retornar valor

Retorna o número de caracteres retornados no buffer ou zero se ocorrer um erro.

Comentários

Observação

O cabeçalho errors.h define AMGetErrorText como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.

Requisitos

Requisito Valor
Plataforma de Destino Windows
Cabeçalho errors.h
Biblioteca Quartz.lib

Confira também

Funções