Método IMFSinkWriter::SetInputMediaType (mfreadwrite.h)

  • Artículo

Establece el formato de entrada de una secuencia en el sistema de escritura receptor.

Sintaxis

HRESULT SetInputMediaType(
  [in] DWORD         dwStreamIndex,
  [in] IMFMediaType  *pInputMediaType,
  [in] IMFAttributes *pEncodingParameters
);

Parámetros

[in] dwStreamIndex

Índice de base cero de la secuencia. El parámetro pdwStreamIndex recibe el índice del método IMFSinkWriter::AddStream .

[in] pInputMediaType

Puntero a la interfaz IMFMediaType de un tipo de medio. El tipo de medio especifica el formato de entrada.

[in] pEncodingParameters

Puntero a la interfaz IMFAttributes de un almacén de atributos. Use el almacén de atributos para configurar el codificador. Este parámetro puede ser NULL.

Valor devuelto

El método devuelve un valor HRESULT. Entre los valores posibles se incluyen los que se indican en la tabla siguiente, entre otros.

Código devuelto Descripción
S_OK
 El método se ha llevado a cabo de forma correcta.
MF_E_INVALIDMEDIATYPE
 El receptor de medios subyacente no admite el formato, no es posible ninguna conversión o no es posible un cambio de formato dinámico.
MF_E_INVALIDSTREAMNUMBER
 El parámetro dwStreamIndex no es válido.
MF_E_TOPO_CODEC_NOT_FOUND
 No se encontró un codificador para el formato codificado.

Comentarios

El formato de entrada no tiene que coincidir con el formato de destino que se escribe en el receptor multimedia. Si los formatos no coinciden, el método intenta cargar un codificador que puede codificar desde el formato de entrada al formato de destino.

Después de que se inicie el streaming (es decir, después de la primera llamada a IMFSinkWriter::WriteSample), puede llamar a este método en cualquier momento para cambiar el formato de entrada. Sin embargo, el codificador subyacente y el receptor de medios deben admitir cambios de formato dinámico.

Esta interfaz está disponible en Windows Vista si está instalado El complemento de actualización de la plataforma para Windows Vista.

Requisitos

Requisito Value
Cliente mínimo compatible Complemento de actualización de Windows 7, Windows Vista y plataforma para Windows Vista [aplicaciones de escritorio | Aplicaciones para UWP]
Servidor mínimo compatible Windows Server 2008 R2 [aplicaciones de escritorio | Aplicaciones para UWP]
Plataforma de destino Windows
Encabezado mfreadwrite.h

Consulte también

IMFSinkWriter

Escritor receptor