Função MFCreateDeviceSourceActivate (mfidl.h)

Cria um objeto de ativação que representa um dispositivo de captura de hardware.

Sintaxe

HRESULT MFCreateDeviceSourceActivate(
  [in]  IMFAttributes *pAttributes,
  [out] IMFActivate   **ppActivate
);

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] ppActivate

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

Retornar valor

Nenhum

Comentários

Essa função cria um objeto de ativação que pode ser usado para criar uma fonte de mídia para um dispositivo de hardware. Para criar a própria fonte de mídia, chame IMFActivate::ActivateObject.

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

Objetos de ativação

Captura de áudio/vídeo na Media Foundation

Capturar atributos de dispositivo

MFCreateDeviceSource

Funções do Media Foundation