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

  • Artigo

Obtém um formato compatível com um dos fluxos de captura.

Sintaxe

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

Parâmetros

[in] dwSourceStreamIndex

O fluxo a ser consultado. O valor pode ser qualquer um dos seguintes.

Valor Significado
0 a 0xFFFFFFFB
 O índice baseado em zero de um fluxo. Para obter o número de fluxos, chame IMFCaptureSource::GetDeviceStreamCount.
MF_CAPTURE_ENGINE_FIRST_SOURCE_PHOTO_STREAM
0xFFFFFFFB
 O primeiro fluxo de imagem.
MF_CAPTURE_ENGINE_FIRST_SOURCE_VIDEO_STREAM
0xFFFFFFFC
 O primeiro fluxo de vídeo.
MF_CAPTURE_ENGINE_FIRST_SOURCE_AUDIO_STREAM
0xFFFFFFFD
 O primeiro fluxo de áudio.

[in] dwMediaTypeIndex

O índice baseado em zero do tipo de mídia a ser recuperado.

[in] ppMediaType

Recebe um ponteiro para a interface IMFMediaType . O chamador deve liberar a interface .

Retornar valor

Esse método pode retornar um desses valores.

Código de retorno Descrição
S_OK
 Êxito.
MF_E_INVALIDSTREAMNUMBER
 O parâmetro dwSourceStreamIndex é inválido.
MF_E_NO_MORE_TYPES
 O parâmetro dwMediaTypeIndex está fora do intervalo.

Comentários

Para enumerar todos os formatos disponíveis em um fluxo, chame esse método em um loop enquanto incrementa dwMediaTypeIndex, até que o método retorne MF_E_NO_MORE_TYPES.

Algumas câmeras podem dar suporte a uma variedade de taxas de quadros. As taxas de quadros mínimas e máximas são armazenadas nos atributos MF_MT_FRAME_RATE_RANGE_MIN e MF_MT_FRAME_RATE_RANGE_MAX no tipo de mídia.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 8 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2012 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho mfcaptureengine.h

Confira também

IMFCaptureSource