Metodo IMFSourceReader::GetNativeMediaType (mfreadwrite.h)

  • Articolo

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