IFilterMapper ::RegisterFilterInstance, méthode (strmif.h)

[La fonctionnalité associée à cette page, DirectShow, est une fonctionnalité héritée. Il a été remplacé par MediaPlayer, IMFMediaEngine et Audio/Video Capture dans Media Foundation. Ces fonctionnalités ont été optimisées pour Windows 10 et Windows 11. Microsoft recommande vivement au nouveau code d’utiliser MediaPlayer, IMFMediaEngine et La capture audio/vidéo dans Media Foundation au lieu de DirectShow, lorsque cela est possible. Microsoft suggère que le code existant qui utilise les API héritées soit réécrit pour utiliser les nouvelles API si possible.]

Syntaxe

HRESULT RegisterFilterInstance(
  [in]  CLSID   clsid,
  [in]  LPCWSTR Name,
  [out] CLSID   *MRId
);

Paramètres

[in] clsid

GUID du filtre.

[in] Name

Nom descriptif du instance.

[out] MRId

Pointeur vers l’ID de ressource multimédia retourné. Ce paramètre est un identificateur local unique pour cette instance de ce filtre.

Valeur retournée

Retourne une valeur HRESULT .

Remarques

Cette méthode gère les cas où deux cartes son similaires pilotées par le même pilote sont disponibles, et il est nécessaire de choisir l’carte émettre le son. Cela n’est pas nécessaire s’il n’existe qu’une seule instance du filtre (par exemple, lorsqu’il n’y a qu’un seul carte sonore dans l’ordinateur), ou si toutes les instances du filtre sont équivalentes.

Le filtre lui-même doit avoir déjà été inscrit.

Configuration requise

Voir aussi

Codes d’erreur et de réussite

IFilterMapper Interface