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

  • Artículo

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