Función AMGetErrorTextA (errors.h)

[La característica asociada a esta página, DirectShow, es una característica heredada. Se ha reemplazado por MediaPlayer, IMFMediaEnginey captura de audio y vídeo en Media Foundation. Esas características se han optimizado para Windows 10 y Windows 11. Microsoft recomienda encarecidamente que el nuevo código use MediaPlayer, IMFMediaEngine y captura de audio y vídeo en Media Foundation en lugar de DirectShow, siempre que sea posible. Microsoft sugiere que el código existente que usa las API heredadas se reescriba para usar las nuevas API si es posible.

La función AMGetErrorText recupera el mensaje de error de un código de retorno determinado mediante la configuración de idioma actual.

Esta función convierte HRESULT códigos de retorno en mensajes de error. La constante MAX_ERROR_TEXT_LEN especifica el número máximo de caracteres en un mensaje de error.

Sintaxis

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

Parámetros

hr

valor de HRESULT.

pbuffer

Puntero a un búfer de caracteres que recibe el mensaje de error.

MaxLen

Número de caracteres de pBuffer.

Valor devuelto

Devuelve el número de caracteres devueltos en el búfer o cero si se produjo un error.

Observaciones

Nota

El encabezado errors.h define AMGetErrorText como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Conventions for Function Prototypes.

Requisitos

Requisito	Valor
de la plataforma de destino de	Windows
encabezado de	errors.h
biblioteca de	Quartz.lib

Consulte también

funciones de