Metodo IMFSourceReader::GetNativeMediaType (mfreadwrite.h)

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 su cui eseguire la query. Il valore può essere uno dei seguenti.

Value	Meaning
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 su cui eseguire la query. Il valore può essere uno dei seguenti.

Value	Meaning
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 HRESULT. I valori possibili includono, ma non solo, quelli nella tabella seguente.

Codice restituito	Description
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.

Osservazioni:

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 il supplemento di aggiornamento della piattaforma per Windows Vista.

Requisiti

Requisito	Value
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
Header	mfreadwrite.h

Vedere anche

IMFSourceReader

Lettore di origine