Função MFCreateDeviceSource (mfidl.h)

  • Artigo

Cria uma fonte de mídia para um dispositivo de captura de hardware.

Sintaxe

HRESULT MFCreateDeviceSource(
  [in]  IMFAttributes  *pAttributes,
  [out] IMFMediaSource **ppSource
);

Parâmetros

[in] pAttributes

Ponteiro para a interface IMFAttributes de um repositório de atributos, que é usado para selecionar o dispositivo. Consulte Observações.

[out] ppSource

Recebe um ponteiro para a interface IMFMediaSource da fonte de mídia. O chamador deve liberar a interface.

Retornar valor

Se essa função for bem-sucedida, ela retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Comentários

Importante Quando o dispositivo de captura não for mais necessário, você deverá desligar o dispositivo chamando Shutdown no objeto IMFMediaSource obtido chamando MFCreateDeviceSource. A falha ao chamar Desligamento pode resultar em links de memória porque o sistema pode manter uma referência aos recursos IMFMediaSource até que o Desligamento seja chamado.
 
O parâmetro pAttributes especifica um repositório de atributos. Para criar o repositório de atributos, chame a função MFCreateAttributes . Você deve definir o atributo MF_DEVSOURCE_ATTRIBUTE_SOURCE_TYPE , que especifica o tipo de dispositivo (áudio ou vídeo).

Para dispositivos de captura de áudio, opcionalmente, defina um dos seguintes atributos:

Atributo Descrição
MF_DEVSOURCE_ATTRIBUTE_SOURCE_TYPE_AUDCAP_ENDPOINT_ID Especifica a ID do ponto de extremidade de áudio do dispositivo de captura de áudio.
MF_DEVSOURCE_ATTRIBUTE_SOURCE_TYPE_AUDCAP_ROLE Especifica a função do dispositivo. Se esse atributo for definido, a função usará o dispositivo de captura de áudio padrão para essa função de dispositivo.

Não combine esse atributo com o atributo MF_DEVSOURCE_ATTRIBUTE_SOURCE_TYPE_AUDCAP_ENDPOINT_ID .
 

Se nenhum atributo for especificado, a função selecionará o dispositivo de captura de áudio padrão para a função eCommunications .

Para dispositivos de captura de vídeo, você deve definir o seguinte atributo:

Atributo Descrição
MF_DEVSOURCE_ATTRIBUTE_SOURCE_TYPE_VIDCAP_SYMBOLIC_LINK Especifica o link simbólico para o dispositivo.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 7 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 R2 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho mfidl.h
Biblioteca Mf.lib
DLL Mf.dll

Confira também

Captura de áudio/vídeo no Media Foundation

Capturar atributos de dispositivo

MFCreateDeviceSourceActivate

Funções do Media Foundation