Objet MSDVDAdm

[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.]

Notes

Ce composant est disponible pour une utilisation dans les systèmes d’exploitation Microsoft Windows 2000, Windows XP et Windows Server 2003. Il sera peut-être modifié ou indisponible dans les versions ultérieures.

 

Notes

Cette API est déconseillée. Pour plus d’informations sur la lecture et la navigation de DVD dans DirectShow, consultez Applications DVD.

 

Les méthodes et propriétés de l’objet MSDVDAdm « administration » permettent à une application de script de modifier ses paramètres par défaut dans le Registre Microsoft® Windows®. Le Registre est une base de données sur tous les systèmes Windows où les applications peuvent stocker des informations sur elles-mêmes pour les utiliser lors de l’initialisation ou pendant l’exécution.

La plupart de ces méthodes et propriétés ne définissent pas ou ne récupèrent pas les valeurs actuelles dans l’objet MSWebDVD lui-même. Cela signifie, par exemple, que lorsque vous appelez GetParentalLevel , la valeur retournée n’est pas le niveau parental actuel stocké dans l’objet. Il s’agit plutôt du niveau parental par défaut stocké dans le registre. Pour obtenir le niveau parental actuel, appelez la méthode MSWebDVDGetPlayerParentalLevel. L’appel de SaveParentalLevel écrit simplement un nouveau niveau d’accès parental par défaut dans le registre ; vous devez toujours appeler la méthode MSWebDVDSelectParentalLevel pour que la modification prenne effet immédiatement dans l’objet MSWebDVD. Les méthodes de l’identificateur de paramètres régionaux par défaut (LCID) fonctionnent de la même manière.

En revanche, les méthodes BookmarkOnStop et BookmarkOnClose prennent effet immédiatement, car l’objet MSWebDVD vérifie ces paramètres juste avant que l’utilisateur arrête la lecture ou ferme l’application, plutôt que pendant l’initialisation.

Vous accédez à l’objet MSDVDAdm via la propriété DVDAdm de MSWebDVD. Par exemple, si l’objet MSWebDVD est nommé « DVD », appelez ChangePassword comme indiqué dans l’exemple de code suivant.

DVD.DVDAdm.ChangePassword(sUserName, sOld, sNew)

Méthodes et propriétés

Le tableau suivant répertorie les méthodes et propriétés exposées par les méthodes et propriétés de l’objet MSDVDAdm.

Méthode	Description
ChangePassword	Enregistre un nouveau mot de passe d’application dans le Registre.
SaveParentalLevel	Enregistre un nouveau niveau parental par défaut dans le Registre.
SaveParentalCountry	Enregistre le nouveau pays/région parental de l’application dans le registre.
ConfirmPassword	Teste si le mot de passe spécifié correspond au mot de passe précédemment enregistré.
GetParentalLevel	Récupère le niveau parental qui a été enregistré pour la dernière fois dans le Registre.
GetParentalCountry	Récupère le pays/la région parentale qui a été enregistré pour la dernière fois dans le registre.
RestoreScreenSaver	Restaure les paramètres de l’économiseur d’écran système.
Propriété	Description
DisableScreenSaver	Active ou désactive l’économiseur d’écran système.
DefaultAudioLCID	Définit ou récupère le paramètre de Registre pour le LCID par défaut spécifié par l’utilisateur pour le flux audio.
DefaultSubpictureLCID	Définit ou récupère le paramètre de Registre pour le LCID par défaut spécifié par l’utilisateur pour le flux de sous-image.
DefaultMenuLCID	Définit ou récupère le paramètre de Registre pour le LCID par défaut spécifié par l’utilisateur pour les menus.
BookmarkOnStop	Définit ou récupère une valeur qui indique à l’objet MSDVDAdm s’il faut enregistrer automatiquement un signet de l’emplacement et des paramètres actuels lorsque l’utilisateur clique sur le bouton Arrêter .
BookmarkOnClose	Définit ou récupère une valeur qui indique à l’objet MSDVDAdm s’il faut enregistrer automatiquement un signet de l’emplacement et des paramètres actuels lorsque l’utilisateur ferme l’application.