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

  • Artigo

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.

Valor Significado
0 a 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 .

Retornar valor

Esse método pode retornar um desses valores.

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

Comentários

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 métodos IMFTransform a seguir pode ter resultados inesperados.

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

Para evitar a perda de dados, você deve esvaziar o leitor de origem antes de chamar esse método. Para obter mais informações, consulte Esvaziando o pipeline de dados.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 8 [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte Windows Server 2012 [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino Windows
Cabeçalho mfreadwrite.h

Confira também

IMFSourceReaderEx