Método IAMErrorLog::LogError

[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.

Nota:

[Desusado. Esta API se puede quitar de futuras versiones de Windows.

 

El método LogError registra un error. Las aplicaciones no necesitan llamar a este método. Se llama internamente en respuesta a errores de representación.

Sintaxis

HRESULT LogError(
       LONG    Severity,
       BSTR    ErrorString,
       LONG    ErrorCode,
       HRESULT hresult,
  [in] VARIANT *pExtraInfo
);

Parámetros

Gravedad

Reservado. No utilizar.

ErrorString

Valor de cadena que contiene el texto del error.

ErrorCode

Código de error.

hresult

Valor HRESULT devuelto por la llamada al método que provocó el error.

pExtraInfo [in]

Puntero a un variant que contiene información adicional sobre el error.

Valor devuelto

Devuelve el valor del parámetro hresult .

Observaciones

Dentro de este método, no libere la VARIANTE a la que apunta pExtraInfo. Además, variant deja de ser válido después de que el método devuelva, por lo que no intente hacer referencia a él más adelante.

Implemente este método para que se devuelva lo más rápido posible. No realice llamadas de función desde dentro de este método que puedan bloquear la ejecución del programa. Por ejemplo, no llame a funciones que envíen mensajes de ventana, bloqueen eventos o, de lo contrario, podrían bloquear la ejecución. Si lo hace, el equipo podría dejar de responder.

Para obtener una lista de errores definidos por DES, junto con el significado y el tipo de datos de variant al que apunta pExtraInfo, vea Errores de representación.

Nota:

El archivo de encabezado Qedit.h no es compatible con los encabezados de Direct3D posteriores a la versión 7.

 

Nota:

Para obtener Qedit.h, descargue la actualización de Microsoft Windows SDK para Windows Vista y .NET Framework 3.0. Qedit.h no está disponible en el Microsoft Windows SDK para Windows 7 y .NET Framework 3.5 Service Pack 1.

 

Requisitos

Requisito	Value
Encabezado	Qedit.h
Biblioteca	Strmiids.lib

Consulte también

IAMErrorLog (Interfaz)

Códigos de error y éxito