Método IMFCaptureSource::GetAvailableDeviceMediaType (mfcaptureengine.h)

  • Artículo

Obtiene un formato compatible con una de las secuencias de captura.

Sintaxis

HRESULT GetAvailableDeviceMediaType(
  [in] DWORD        dwSourceStreamIndex,
  [in] DWORD        dwMediaTypeIndex,
  [in] IMFMediaType **ppMediaType
);

Parámetros

[in] dwSourceStreamIndex

Secuencia que se va a consultar. El valor puede ser cualquiera de los siguientes.

Valor Significado
0 a 0xFFFFFFFB
 Índice de base cero de una secuencia. Para obtener el número de secuencias, llame a IMFCaptureSource::GetDeviceStreamCount.
MF_CAPTURE_ENGINE_FIRST_SOURCE_PHOTO_STREAM
0xFFFFFFFB
 Primera secuencia de imagen.
MF_CAPTURE_ENGINE_FIRST_SOURCE_VIDEO_STREAM
0xFFFFFFFC
 Primera secuencia de vídeo.
MF_CAPTURE_ENGINE_FIRST_SOURCE_AUDIO_STREAM
0xFFFFFFFD
 Primera secuencia de audio.

[in] dwMediaTypeIndex

Índice de base cero del tipo de medio que se va a recuperar.

[in] ppMediaType

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

Valor devuelto

Este método puede devolver uno de estos valores.

Código devuelto Descripción
S_OK
 Correcto.
MF_E_INVALIDSTREAMNUMBER
 El parámetro dwSourceStreamIndex no es válido.
MF_E_NO_MORE_TYPES
 El parámetro dwMediaTypeIndex está fuera del intervalo.

Comentarios

Para enumerar todos los formatos disponibles en una secuencia, llame a este método en un bucle mientras incrementa dwMediaTypeIndex, hasta que el método devuelva MF_E_NO_MORE_TYPES.

Algunas cámaras pueden admitir una gama de velocidades de fotogramas. Las velocidades de fotogramas mínimas y máximas se almacenan en los atributos MF_MT_FRAME_RATE_RANGE_MIN y MF_MT_FRAME_RATE_RANGE_MAX en el tipo de medio.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 8 [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2012 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado mfcaptureengine.h

Consulte también

IMFCaptureSource