Share via


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

Obtiene un puntero a una transformación de Media Foundation (MFT) para una secuencia especificada.

Sintaxis

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

Parámetros

[in] dwStreamIndex

Secuencia que se va a consultar para el MFT. El valor puede ser cualquiera de los siguientes.

Valor Significado
0 a 0xFFFFFFFB
Índice de base cero de una secuencia.
MF_SOURCE_READER_FIRST_VIDEO_STREAM
0xFFFFFFFC
Primera secuencia de vídeo.
MF_SOURCE_READER_FIRST_AUDIO_STREAM
0xFFFFFFFD
Primera secuencia de audio.

[in] dwTransformIndex

Índice de base cero del MFT que se va a recuperar.

[out] pGuidCategory

Recibe un GUID que especifica la categoría del MFT. Para obtener una lista de los valores posibles, consulte MFT_CATEGORY.

[out] ppTransform

Recibe un puntero a la interfaz IMFTransform del MFT. El autor de la llamada debe liberar la interfaz .

Valor devuelto

Este método puede devolver uno de estos valores.

Código devuelto Descripción
S_OK
Correcto.
MF_E_INVALIDINDEX
El parámetro dwTransformIndex está fuera del intervalo.
MF_E_INVALIDSTREAMNUMBER
El parámetro dwStreamIndex no es válido.

Comentarios

Puede usar este método para configurar un MFT después de insertarlo en la cadena de procesamiento. No use el puntero devuelto en ppTransform para establecer tipos multimedia en MFT o para procesar datos. En concreto, llamar a cualquiera de los siguientes métodos IMFTransform podría tener resultados inesperados.

Si hay un descodificador presente, aparece en la posición de índice cero.

Para evitar la pérdida de datos, debe purgar el lector de origen antes de llamar a este método. Para obtener más información, consulte Purgar la canalización de datos.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 8 [aplicaciones de escritorio | Aplicaciones para UWP]
Servidor mínimo compatible Windows Server 2012 [aplicaciones de escritorio | Aplicaciones para UWP]
Plataforma de destino Windows
Encabezado mfreadwrite.h

Consulte también

IMFSourceReaderEx