Funzione AMGetErrorTextA (errors.h)

  • Articolo

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

La funzione AMGetErrorText recupera il messaggio di errore per un determinato codice restituito, usando l'impostazione della lingua corrente.

Questa funzione converte i codici restituiti HRESULT 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.

Commenti

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 che non è indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzioni.

Requisiti

Requisito Valore
Piattaforma di destinazione Windows
Intestazione errors.h
Libreria Quarzi.lib

Vedi anche

Funzioni