Metodo ITAMMediaFormat::p ut_MediaFormat (tapi3.h)

Articolo
08/26/2023

Il metodo put_MediaFormat imposta il formato multimediale.

Sintassi

HRESULT put_MediaFormat(
  [in] const AM_MEDIA_TYPE *pmt
);

Parametri

[in] pmt

Puntatore alla struttura AM_MEDIA_TYPE . Per altre informazioni su AM_MEDIA_TYPE, vedere la documentazione di DirectX.

Valore restituito

Questo metodo può restituire uno di questi valori.

Codice restituito	Descrizione
S_OK	Il metodo è riuscito.
E_OUTOFMEMORY	Memoria insufficiente per eseguire l'operazione.

Commenti

Negli indirizzi in cui sono supportati diversi formati (ad esempio indirizzi Wave MSP, usati nella maggior parte dei modem e schede vocali), questa chiamata è obbligatoria o il terminale non sarà in grado di connettersi.

Per altri indirizzi, ad esempio quelli implementati tramite IP, il formato può essere fisso/predeterminato. In questo caso, questa chiamata avrà esito negativo se il formato non è uguale al formato predeterminato. Per recuperare un formato predeterminato, un'applicazione può usare get_MediaFormat.