Fonction MFCreateDeviceSourceActivate (mfidl.h)

  • Article

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