Fonction MFCreateDeviceSourceActivate (mfidl.h)

Article
08/24/2023

Crée un objet d’activation qui représente un appareil de capture matérielle.

Syntaxe

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

Paramètres

[in] pAttributes

Pointeur vers l’interface IMFAttributes d’un magasin d’attributs, qui est utilisé pour sélectionner l’appareil. Consultez la section Notes.

[out] ppActivate

Reçoit un pointeur vers l’interface IMFActivate . L’appelant doit libérer l’interface.

Valeur de retour

None

Remarques

Cette fonction crée un objet d’activation qui peut être utilisé pour créer une source multimédia pour un appareil matériel. Pour créer la source multimédia proprement dite, appelez IMFActivate ::ActivateObject.

Le paramètre pAttributes spécifie un magasin d’attributs. Pour créer le magasin d’attributs, appelez la fonction MFCreateAttributes . Vous devez définir l’attribut MF_DEVSOURCE_ATTRIBUTE_SOURCE_TYPE , qui spécifie le type d’appareil (audio ou vidéo).

Pour les périphériques de capture audio, définissez éventuellement l’un des attributs suivants :

Attribut	Description
MF_DEVSOURCE_ATTRIBUTE_SOURCE_TYPE_AUDCAP_ENDPOINT_ID	Spécifie l’ID de point de terminaison audio de l’appareil de capture audio.
MF_DEVSOURCE_ATTRIBUTE_SOURCE_TYPE_AUDCAP_ROLE	Spécifie le rôle d’appareil. Si cet attribut est défini, la fonction utilise le périphérique de capture audio par défaut pour ce rôle d’appareil. Ne combinez pas cet attribut avec l’attribut MF_DEVSOURCE_ATTRIBUTE_SOURCE_TYPE_AUDCAP_ENDPOINT_ID .

Si aucun attribut n’est spécifié, la fonction sélectionne le périphérique de capture audio par défaut pour le rôle eCommunications .

Pour les appareils de capture vidéo, vous devez définir l’attribut suivant :

Attribut	Description
MF_DEVSOURCE_ATTRIBUTE_SOURCE_TYPE_VIDCAP_SYMBOLIC_LINK	Spécifie le lien symbolique vers l’appareil.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 7 [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 R2 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	mfidl.h
Bibliothèque	Mf.lib
DLL	Mf.dll

Voir aussi

Objets d’activation

Capture audio/vidéo dans Media Foundation

Capturer des attributs d’appareil

MFCreateDeviceSource

Fonctions Media Foundation

Partager via