Metodo IMFSourceReader::GetNativeMediaType (mfreadwrite.h)

Articolo
02/28/2024

Ottiene un formato supportato in modo nativo dall'origine multimediale.

Sintassi

HRESULT GetNativeMediaType(
  [in]  DWORD        dwStreamIndex,
  [in]  DWORD        dwMediaTypeIndex,
  [out] IMFMediaType **ppMediaType
);

Parametri

[in] dwStreamIndex

Specifica il flusso di cui eseguire la query. Il valore può essere uno dei seguenti.

Valore	Significato
0-0xFFFFFFFB	Indice in base zero di un flusso.
MF_SOURCE_READER_FIRST_VIDEO_STREAM 0xFFFFFFFC	Primo flusso video.
MF_SOURCE_READER_FIRST_AUDIO_STREAM 0xFFFFFFFD	Primo flusso audio.

[in] dwMediaTypeIndex

Specifica il tipo di supporto da eseguire per la query. Il valore può essere uno dei seguenti.

Valore	Significato
0-0xFFFFFFFE	Indice in base zero di un tipo di supporto
MF_SOURCE_READER_CURRENT_TYPE_INDEX 0xffffffff	Tipo di supporto nativo corrente.

[out] ppMediaType

Riceve un puntatore all'interfaccia IMFMediaType . Il chiamante deve rilasciare l'interfaccia.

Valore restituito

Il metodo restituisce un valore HRESULT. I valori possibili includono, ma non sono limitati a, quelli indicati nella tabella seguente.

Codice restituito	Descrizione
S_OK	Il metodo è riuscito.
MF_E_INVALIDSTREAMNUMBER	Il parametro dwStreamIndex non è valido.
MF_E_NO_MORE_TYPES	Il parametro dwMediaTypeIndex non è compreso nell'intervallo.

Commenti

Questo metodo esegue una query sull'origine multimediale sottostante per il formato di output nativo. Potenzialmente, ogni flusso di origine può produrre più di un formato di output. Usare il parametro dwMediaTypeIndex per scorrere i formati disponibili. In genere, le origini file offrono un solo formato per flusso, ma i dispositivi di acquisizione possono offrire diversi formati.

Il metodo restituisce una copia del tipo di supporto, pertanto è possibile modificare l'oggetto ricevuto nel parametro ppMediaType .

Per impostare il tipo di output per un flusso, chiamare il metodo IMFSourceReader::SetCurrentMediaType .

Questa interfaccia è disponibile in Windows Vista se è installato Platform Update Supplement per Windows Vista.

Requisiti

Requisito	Valore
Client minimo supportato	Supplemento per Windows 7, Windows Vista e Aggiornamento della piattaforma per Windows Vista [app desktop \| App UWP]
Server minimo supportato	Windows Server 2008 R2 [app desktop \| App UWP]
Piattaforma di destinazione	Windows
Intestazione	mfreadwrite.h

Vedi anche

IMFSourceReader

Lettore di origine

Condividi tramite