Función MFCreateDeviceSourceActivate (mfidl.h)

  • Artículo

Crea un objeto de activación que representa un dispositivo de captura de hardware.

Sintaxis

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

Parámetros

[in] pAttributes

Puntero a la interfaz IMFAttributes de un almacén de atributos, que se usa para seleccionar el dispositivo. Vea la sección Comentarios.

[out] ppActivate

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

Valor devuelto

None

Observaciones

Esta función crea un objeto de activación que se puede usar para crear un origen multimedia para un dispositivo de hardware. Para crear el propio origen multimedia, llame a IMFActivate::ActivateObject.

El parámetro pAttributes especifica un almacén de atributos. Para crear el almacén de atributos, llame a la función MFCreateAttributes . Debe establecer el atributo MF_DEVSOURCE_ATTRIBUTE_SOURCE_TYPE , que especifica el tipo de dispositivo (audio o vídeo).

En el caso de los dispositivos de captura de audio, establezca opcionalmente uno de los siguientes atributos:

Atributo Descripción
MF_DEVSOURCE_ATTRIBUTE_SOURCE_TYPE_AUDCAP_ENDPOINT_ID Especifica el identificador del punto de conexión de audio del dispositivo de captura de audio.
MF_DEVSOURCE_ATTRIBUTE_SOURCE_TYPE_AUDCAP_ROLE Especifica el rol de dispositivo. Si se establece este atributo, la función usa el dispositivo de captura de audio predeterminado para ese rol de dispositivo.

No combine este atributo con el atributo MF_DEVSOURCE_ATTRIBUTE_SOURCE_TYPE_AUDCAP_ENDPOINT_ID .
 

Si no se especifica ningún atributo, la función selecciona el dispositivo de captura de audio predeterminado para el rol de eCommunications .

En el caso de los dispositivos de captura de vídeo, debe establecer el atributo siguiente:

Atributo Descripción
MF_DEVSOURCE_ATTRIBUTE_SOURCE_TYPE_VIDCAP_SYMBOLIC_LINK Especifica el vínculo simbólico al dispositivo.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 7 [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 R2 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado mfidl.h
Library Mf.lib
Archivo DLL Mf.dll

Consulte también

Objetos de activación

Captura de audio y vídeo en Media Foundation

Capturar atributos de dispositivo

MFCreateDeviceSource

Funciones de Media Foundation