Partager via


IAMPluginControl ::GetPreferredClsidByIndex, 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 in Media Foundation. Ces fonctionnalités ont été optimisées pour Windows 10 et Windows 11. Microsoft recommande vivement que le nouveau code utilise MediaPlayer, IMFMediaEngine et Audio/Video Capture dans Media Foundation au lieu de DirectShow, si 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.]

Obtient un identificateur de classe (CLSID) à partir de la liste par défaut, spécifiée par la valeur d’index.

Syntaxe

HRESULT GetPreferredClsidByIndex(
  [in]  DWORD index,
  [out] GUID  *subType,
  [out] CLSID *clsid
);

Paramètres

[in] index

Index de base zéro du CLSID à récupérer.

[out] subType

Reçoit le GUID de sous-type associé au CLSID.

[out] clsid

Reçoit le CLSID à l’index spécifié.

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_NO_MORE_ITEMS)
Le paramètre d’index est hors limites.

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