Partager via


IAMPluginControl ::GetPreferredClsid, 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.]

Recherche dans la liste par défaut un identificateur de classe (CLSID) qui correspond à un sous-type spécifié.

Syntaxe

HRESULT GetPreferredClsid(
  [in]  REFGUID subType,
  [out] CLSID   *clsid
);

Paramètres

[in] subType

GUID de sous-type multimédia à correspondre.

[out] clsid

Reçoit un CLSID de la liste par défaut.

Valeur retournée

Cette méthode peut retourner l’une de ces valeurs.

Code de retour Description
S_OK
S_OK
HRESULT_FROM_WIN32(ERROR_NOT_FOUND)
Aucun CLSID correspondant à ce sous-type n’a été trouvé.

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 strmif.h (include Dshow.h)

Voir aussi

IAMPluginControl

Connexion intelligente