Metodo IMFSourceReaderEx::GetTransformForStream (mfreadwrite.h)

Ottiene un puntatore a una trasformazione Media Foundation (MFT) per un flusso specificato.

Sintassi

HRESULT GetTransformForStream(
  [in]  DWORD        dwStreamIndex,
  [in]  DWORD        dwTransformIndex,
  [out] GUID         *pGuidCategory,
  [out] IMFTransform **ppTransform
);

Parametri

[in] dwStreamIndex

Flusso da eseguire una query per MFT. 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	Il primo flusso audio.

[in] dwTransformIndex

Indice in base zero del MFT da recuperare.

[out] pGuidCategory

Riceve un GUID che specifica la categoria di MFT. Per un elenco di valori possibili, vedere MFT_CATEGORY.

[out] ppTransform

Riceve un puntatore all'interfaccia FMTransform del MFT. Il chiamante deve rilasciare l'interfaccia.

Valore restituito

Questo metodo può restituire uno di questi valori.

Codice restituito	Descrizione
S_OK	Operazione completata.
MF_E_INVALIDINDEX	Il parametro dwTransformIndex non è compreso nell'intervallo.
MF_E_INVALIDSTREAMNUMBER	Il parametro dwStreamIndex non è valido.

Commenti

È possibile usare questo metodo per configurare un MFT dopo l'inserimento nella catena di elaborazione. Non usare il puntatore restituito in ppTransform per impostare i tipi di supporti nel MFT o per elaborare i dati. In particolare, chiamare uno dei seguenti metodi FMTransform potrebbe avere risultati imprevisti.

• AddInputStreams
• DeleteInputStream
• ProcessEvent
• ProcessInput
• ProcessMessage
• ProcessOutput
• SetInputType
• SetOutputType

Se è presente un decodificatore, viene visualizzato in posizione di indice zero.

Per evitare di perdere dati, è necessario svuotare il lettore di origine prima di chiamare questo metodo. Per altre informazioni, vedere Svuotare la pipeline di dati.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 8 [app desktop | App UWP]
Server minimo supportato	Windows Server 2012 [app desktop | App UWP]
Piattaforma di destinazione	Windows
Intestazione	mfreadwrite.h

Vedi anche

FMSourceReaderEx