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

Obtiene un formato admitido de forma nativa por el origen multimedia.

Sintaxis

HRESULT GetNativeMediaType(
  [in]  DWORD        dwStreamIndex,
  [in]  DWORD        dwMediaTypeIndex,
  [out] IMFMediaType **ppMediaType
);

Parámetros

[in] dwStreamIndex

Especifica qué secuencia se va a consultar. 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] dwMediaTypeIndex

Especifica qué tipo de medio se va a consultar. El valor puede ser cualquiera de los siguientes.

Valor	Significado
0-0xFFFFFFFE	Índice de base cero de un tipo de medio
MF_SOURCE_READER_CURRENT_TYPE_INDEX 0xffffffff	El tipo de medio nativo actual.

[out] ppMediaType

Recibe un puntero a la interfaz IMFMediaType . El autor de la llamada debe liberar la interfaz .

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_INVALIDSTREAMNUMBER	El parámetro dwStreamIndex no es válido.
MF_E_NO_MORE_TYPES	El parámetro dwMediaTypeIndex está fuera del intervalo.

Comentarios

Este método consulta el origen multimedia subyacente para su formato de salida nativo. Potencialmente, cada flujo de origen puede producir más de un formato de salida. Use el parámetro dwMediaTypeIndex para recorrer en bucle los formatos disponibles. Por lo general, los orígenes de archivos ofrecen solo un formato por secuencia, pero los dispositivos de captura pueden ofrecer varios formatos.

El método devuelve una copia del tipo de medio, por lo que es seguro modificar el objeto recibido en el parámetro ppMediaType .

Para establecer el tipo de salida de una secuencia, llame al método IMFSourceReader::SetCurrentMediaType .

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