Fonction MFCreateDeviceSource (mfidl.h)

Article
02/28/2024

Crée une source multimédia pour un appareil de capture matérielle.

Syntaxe

HRESULT MFCreateDeviceSource(
  [in]  IMFAttributes  *pAttributes,
  [out] IMFMediaSource **ppSource
);

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

Reçoit un pointeur vers l’interface IMFMediaSource de la source multimédia. L’appelant doit libérer l’interface.

Valeur retournée

Si cette fonction réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Remarques

Important Lorsque l’appareil de capture n’est plus nécessaire, vous devez l’arrêter en appelant Shutdown sur l’objet IMFMediaSource que vous avez obtenu en appelant MFCreateDeviceSource. L’échec de l’appel de l’arrêt peut entraîner des liaisons mémoire, car le système peut conserver une référence aux ressources IMFMediaSource jusqu’à ce que l’arrêt soit appelé.

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

Capture audio/vidéo dans Media Foundation

Capturer des attributs d’appareil

MFCreateDeviceSourceActivate

Fonctions Media Foundation

Partager via