Metodo IAMErrorLog::LogError
[La funzionalità associata a questa pagina, DirectShow, è una funzionalità legacy. È stata sostituita da MediaPlayer, IMFMediaEngine e Audio/Video Capture in Media Foundation. Queste funzionalità sono state ottimizzate per Windows 10 e Windows 11. Microsoft consiglia vivamente che il nuovo codice usi MediaPlayer, IMFMediaEngine e Audio/Video Capture in Media Foundation invece di DirectShow, quando possibile. Microsoft suggerisce che il codice esistente che usa le API legacy venga riscritto per usare le nuove API, se possibile.
Nota
[Deprecata. Questa API può essere rimossa dalle versioni future di Windows.]
Il metodo LogError registra un errore. Le applicazioni non devono chiamare questo metodo. Viene chiamato internamente in risposta agli errori di rendering.
Sintassi
HRESULT LogError(
LONG Severity,
BSTR ErrorString,
LONG ErrorCode,
HRESULT hresult,
[in] VARIANT *pExtraInfo
);
Parametri
-
Gravità
-
Riservato. Non usare.
-
ErrorString
-
Valore stringa contenente il testo dell'errore.
-
ErrorCode
-
Codice di errore.
-
Hresult
-
Valore HRESULT restituito dalla chiamata al metodo che ha causato l'errore.
-
pExtraInfo [in]
-
Puntatore a un valore VARIANT contenente eventuali informazioni aggiuntive sull'errore.
Valore restituito
Restituisce il valore del parametro hresult .
Commenti
All'interno di questo metodo, non liberare la variante a cui punta pExtraInfo. Inoltre , variant diventa non valido dopo la restituzione del metodo, quindi non provare a farvi riferimento in un secondo momento.
Implementare questo metodo per restituire il più rapidamente possibile. Non effettuare chiamate di funzione dall'interno di questo metodo che potrebbe bloccare l'esecuzione del programma. Ad esempio, non chiamare funzioni che inviano messaggi finestra, bloccano gli eventi o altrimenti bloccano l'esecuzione. In questo modo, il computer smette di rispondere.
Per un elenco di errori definiti da DES, insieme al significato e al tipo di dati di VARIANT a cui punta pExtraInfo, vedere Errori di rendering.
Nota
Il file di intestazione Qedit.h non è compatibile con le intestazioni Direct3D successive alla versione 7.
Nota
Per ottenere Qedit.h, scaricare l'aggiornamento Microsoft Windows SDK per Windows Vista e .NET Framework 3.0. Qedit.h non è disponibile nella Microsoft Windows SDK per Windows 7 e .NET Framework 3.5 Service Pack 1.
Requisiti
| Requisito | Valore |
|---|---|
| Intestazione |
|
| Libreria |
|
Vedi anche