Método IMFSourceReaderEx::SetNativeMediaType (mfreadwrite.h)
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 |
---|---|
|
Todos los efectos se quitaron de la secuencia. |
|
El tipo de salida actual ha cambiado. |
Valor devuelto
Este método puede devolver uno de estos valores.
Código devuelto | Descripción |
---|---|
|
Correcto. |
|
Solicitud no válida. |
|
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 |