Compartilhar via


Método IMFSourceReaderEx::GetTransformForStream (mfreadwrite.h)

Obtém um ponteiro para uma MFT (transformação do Media Foundation) para um fluxo especificado.

Sintaxe

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

Parâmetros

[in] dwStreamIndex

O fluxo a ser consultado para o MFT. O valor pode ser qualquer um dos seguintes.

Value Meaning
0–0xFFFFFFFB
O índice baseado em zero de um fluxo.
MF_SOURCE_READER_FIRST_VIDEO_STREAM
0xFFFFFFFC
O primeiro fluxo de vídeo.
MF_SOURCE_READER_FIRST_AUDIO_STREAM
0xFFFFFFFD
O primeiro fluxo de áudio.

[in] dwTransformIndex

O índice baseado em zero do MFT a ser recuperado.

[out] pGuidCategory

Recebe um GUID que especifica a categoria do MFT. Para obter uma lista de valores possíveis, consulte MFT_CATEGORY.

[out] ppTransform

Recebe um ponteiro para a interface IMFTransform do MFT. O chamador deve liberar a interface.

Valor de retorno

Esse método pode retornar um desses valores.

Código de retorno Description
S_OK
Êxito.
MF_E_INVALIDINDEX
O parâmetro dwTransformIndex está fora do intervalo.
MF_E_INVALIDSTREAMNUMBER
O parâmetro dwStreamIndex é inválido.

Observações

Você pode usar esse método para configurar um MFT depois que ele é inserido na cadeia de processamento. Não use o ponteiro retornado em ppTransform para definir tipos de mídia no MFT ou para processar dados. Em particular, chamar qualquer um dos seguintes métodos IMFTransform pode ter resultados inesperados.

Se um decodificador estiver presente, ele aparecerá na posição de índice zero.

Para evitar perder dados, você deve esvaziar o leitor de origem antes de chamar esse método. Para obter mais informações, consulte Drenando o Pipeline de Dados.

Requirements

Requirement Value
Cliente mínimo suportado Windows 8 [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo compatível Windows Server 2012 [aplicativos da área de trabalho | Aplicativos UWP]
da Plataforma de Destino Windows
Header mfreadwrite.h

Consulte também

IMFSourceReaderEx