Funzione CreateAudioMediaType

Articolo
07/28/2023

[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 CreateAudioMediaType inizializza un tipo di supporto da una struttura WAVEFORMATEX .

Sintassi

HRESULT STDAPI CreateAudioMediaType(
   const WAVEFORMATEX  *pwfx,
         AM_MEDIA_TYPE *pmt,
         BOOL          bSetFormat
);

Parametri

pwfx: Puntatore alla struttura WAVEFORMATEX fornita.
Pmt: Puntatore alla struttura AM_MEDIA_TYPE da inizializzare.
bSetFormat: Flag che indica se inizializzare il blocco di formato. Specificare TRUE per inizializzarlo o FALSE in caso contrario.

Valore restituito

Restituisce E_OUTOFMEMORY se non è stato possibile allocare memoria per i dati di formato; S_OK in caso contrario.

Commenti

Se il parametro bSetFormat è TRUE, il metodo alloca la memoria per il blocco di formato. Se il parametro pmt contiene già un blocco di formato allocato, si verificherà una perdita di memoria. Per evitare una perdita di memoria, chiamare FreeMediaType prima di chiamare questa funzione. Al termine del metodo, chiamare di nuovo FreeMediaType per liberare il blocco di formato.

Requisiti

Requisito	Valore
Intestazione	Mtype.h (include Streams.h)
Libreria	Strmbase.lib (build retail); Strmbasd.lib (build di debug)

Vedi anche

Funzioni del tipo di supporto

Share via