Método IMFSourceReader::SetStreamSelection (mfreadwrite.h)

  • Artículo

Selecciona o anula la selección de una o varias secuencias.

Sintaxis

HRESULT SetStreamSelection(
  [in] DWORD dwStreamIndex,
  [in] BOOL  fSelected
);

Parámetros

[in] dwStreamIndex

Secuencia que se va a establecer. 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.
MF_SOURCE_READER_ALL_STREAMS
0xFFFFFFFE
 Todas las secuencias.

[in] fSelected

Especifique TRUE para seleccionar secuencias o FALSE para anular la selección de secuencias. Si se deselecciona una secuencia, no generará datos.

Valor devuelto

Si este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.

Comentarios

Hay dos usos comunes para este método:

  • Para cambiar la selección de secuencia predeterminada. Algunos archivos multimedia contienen varias secuencias del mismo tipo. Por ejemplo, un archivo podría incluir secuencias de audio para varios idiomas. Puede usar este método para cambiar cuál de las secuencias está seleccionada. Para obtener información sobre cada secuencia, llame a IMFSourceReader::GetPresentationAttribute o IMFSourceReader::GetNativeMediaType.
  • Si no necesita datos de una de las secuencias, es recomendable anular la selección de esa secuencia. Si se selecciona la secuencia, el origen multimedia puede contener una cola de datos no leídos y la cola puede crecer indefinidamente y consumir memoria.
Para obtener un ejemplo de selección de una secuencia, vea Tutorial: Descodificación de audio.

Si se deselecciona una secuencia, el método IMFSourceReader::ReadSample devuelve MF_E_INVALIDREQUEST para esa secuencia. Otros métodos IMFSourceReader son válidos para secuencias deseleccionados.

Stream selección no afecta a la forma en que el lector de origen carga o descarga descodificadores en memoria. En concreto, la anulación de la selección de una secuencia no obliga al lector de origen a descargar el descodificador de esa secuencia.

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

IMFSourceReader

Lector de origen