Funzione AMGetErrorTextA (errors.h)
[La funzionalità associata a questa pagina, DirectShow, è una funzionalità legacy. È stata sostituita da MediaPlayer, IMFMediaEnginee Acquisizione audio/video in Media Foundation. Queste funzionalità sono state ottimizzate per Windows 10 e Windows 11. Microsoft consiglia vivamente di usare un nuovo codice MediaPlayer, IMFMediaEngine e Acquisizione audio/video in Media Foundation anziché DirectShow, quando possibile. Microsoft suggerisce che il codice esistente che usa le API legacy venga riscritto per usare le nuove API, se possibile.
La funzione AMGetErrorText recupera il messaggio di errore per un determinato codice restituito, usando l'impostazione della lingua corrente.
Questa funzione converte HRESULT codici restituiti in messaggi di errore. La costante MAX_ERROR_TEXT_LEN specifica il numero massimo di caratteri in un messaggio di errore.
Sintassi
AMOVIEAPI DWORD AMGetErrorTextA(
HRESULT hr,
LPSTR pbuffer,
DWORD MaxLen
);
Parametri
hr
valore HRESULT.
pbuffer
Puntatore a un buffer di caratteri che riceve il messaggio di errore.
MaxLen
Numero di caratteri in pBuffer.
Valore restituito
Restituisce il numero di caratteri restituiti nel buffer oppure zero se si è verificato un errore.
Osservazioni
Nota
L'intestazione errors.h definisce AMGetErrorText come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.
Fabbisogno
| Requisito | Valore |
|---|---|
| piattaforma di destinazione | Finestre |
| intestazione |
errors.h |
| libreria |
Quarzi.lib |