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 |