Partager via

Pour charger un profil système

  • Article

[La fonctionnalité associée à cette page, le Kit de développement logiciel (SDK) Windows Media Format 11, est une fonctionnalité héritée. Il a été remplacé par lecteur source et enregistreur récepteur. Le lecteur source et l’enregistreur récepteur ont été optimisés pour Windows 10 et Windows 11. Microsoft recommande vivement que le nouveau code utilise le lecteur source et l’enregistreur récepteur au lieu du Kit de développement logiciel (SDK) Windows Media Format 11, 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.]

Pour apporter des modifications à un profil système, vous devez le charger dans un objet de profil. Le gestionnaire de profils fournit deux options pour charger les profils système : par identificateur et par index.

Un identificateur de profil système est une valeur GUID affectée au profil système lors de sa création. Pour obtenir la liste des constantes GUID associées aux profils système version 8, consultez Profils système. Vous trouverez les constantes GUID pour les versions précédentes dans le fichier d’en-tête WMSysPrf.h. Pour plus d’informations sur ce fichier et les autres fichiers d’en-tête inclus avec le Kit de développement logiciel (SDK) au format Windows Media, consultez Fichiers de bibliothèque et paramètres du compilateur.

L’exemple de code suivant montre comment charger un profil système à l’aide de l’identificateur de profil système. Pour que ce code fonctionne, vous devez inclure WMSysPrf.h et stdio.h. Pour plus d’informations sur l’utilisation de ce code, consultez Utilisation des exemples de code.

IWMProfileManager* pProfileMgr = NULL;
IWMProfile*        pProfile    = NULL;

HRESULT hr = S_OK;

// Initialize COM.
hr = CoInitialize(NULL);

// Create a profile manager.
hr = WMCreateProfileManager(&pProfileMgr);

// Retrieve the data for the general-purpose broadband video profile.
hr = pProfileMgr->LoadProfileByID(WMProfile_V80_100Video, &pProfile);

// TODO: Perform whatever customizations are needed. For details about
// editing profiles, see Using Custom Profiles.

// Clean up.
pProfile->Release();
pProfile = NULL;
pProfileMgr->Release();
pProfileMgr = NULL;

Si vous ne savez pas quel profil vous souhaitez utiliser, vous pouvez itérer tous les profils système d’une version particulière à l’aide des méthodes GetSystemProfileCount et LoadSystemProfile de l’interface IWMProfileManager . Ces méthodes ne traitent qu’une seule version des profils système à la fois. Pour plus d’informations sur la modification de la version du profil système, consultez Pour modifier les versions du profil système.

Utilisation de profils système