Función MFCreateDeviceSourceActivate (mfidl.h)
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
Captura de audio y vídeo en Media Foundation