Función AMGetErrorTextA (errors.h)

[La característica asociada a esta página, DirectShow, es una característica heredada. Se ha reemplazado por MediaPlayer, IMFMediaEngine y Captura de audio/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 Audio/Video Capture 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 los códigos de retorno HRESULT 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 HRESULT .

pbuffer

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

MaxLen

Número de caracteres en pBuffer.

Valor devuelto

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

Comentarios

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 Convenciones para prototipos de función.

Requisitos

Requisito	Value
Plataforma de destino	Windows
Encabezado	errors.h
Library	Quartz.lib

Vea también

Funciones