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

  • Artículo

Establece el tipo de medio nativo para una secuencia en el origen multimedia.

Sintaxis

HRESULT SetNativeMediaType(
  [in]  DWORD        dwStreamIndex,
  [in]  IMFMediaType *pMediaType,
  [out] DWORD        *pdwStreamFlags
);

Parámetros

[in] dwStreamIndex

[in] pMediaType

Puntero a la interfaz IMFMediaType del tipo de medio.

[out] pdwStreamFlags

Recibe un OR bit a bit de cero o más de las marcas siguientes.

Valor Significado
MF_SOURCE_READERF_ALLEFFECTSREMOVED
 Todos los efectos se quitaron de la secuencia.
MF_SOURCE_READERF_CURRENTMEDIATYPECHANGED
 El tipo de salida actual ha cambiado.

Valor devuelto

Este método puede devolver uno de estos valores.

Código devuelto Descripción
S_OK
 Correcto.
MF_E_INVALIDREQUEST
 Solicitud no válida.
MF_E_INVALIDSTREAMNUMBER
 El parámetro dwStreamIndex no es válido.

Comentarios

Este método establece el tipo de salida generado por el origen multimedia. A diferencia del método IMFSourceReader::SetCurrentMediaType , este método no inserta ningún descodificador, procesadores de vídeo u otras transformaciones. El origen de medios debe admitir el tipo de medio especificado de forma nativa. Para obtener una lista de tipos admitidos del origen multimedia, llame a IMFSourceReader::GetNativeMediaType.

En modo asincrónico, este método produce un error si hay una solicitud de ejemplo pendiente. En ese caso, espere a que se invoque la devolución de llamada onReadSample antes de llamar al método . Para obtener más información sobre el uso del Lector de origen en modo asincrónico, vea IMFSourceReader::ReadSample.

Este método puede desencadenar un cambio en el formato de salida de la secuencia. Si es así, la marca MF_SOURCE_READERF_CURRENTMEDIATYPECHANGED se devuelve en el parámetro pdwStreamFlags . El método también puede hacer que el Lector de origen quite los efectos agregados por el método IMFSourceReaderEx::AddTransformForStream . Si esto ocurre, la marca MF_SOURCE_READERF_ALLEFFECTSREMOVED se devuelve en pdwStreamFlags.

Este método es útil con dispositivos de captura de audio y vídeo, ya que un dispositivo puede admitir varios formatos de salida. Este método permite a la aplicación elegir el formato del dispositivo antes de agregar descodificadores y otras transformaciones.

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