Méthode IDvdControl2::SetDVDDirectory (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.]

La SetDVDDirectory méthode définit le lecteur de DVD à partir duquel le filtre Dvd Navigator lit.

Syntaxe

HRESULT SetDVDDirectory(
  [in] LPCWSTR pszwPath
);

Paramètres

[in] pszwPath

Pointeur vers une chaîne de caractères larges qui spécifie le chemin du répertoire racine.

Valeur renvoyée

Retourne l’une des valeurs suivantes.

Code de retour	Description
S_OK	Opération réussie.
E_INVALIDARG	Le paramètre pszwPath pointe vers un chemin de DVD non valide, ou un lecteur de DVD est introuvable lors de l’énumération.
E_UNEXPECTED	Le Navigateur de DVD n’est pas initialisé.
VFW_E_DVD_INVALIDDOMAIN	Domaine non valide. Pour plus d'informations, consultez Notes.

Notes

Si pszwPath a la valeur NULL, le Navigateur de DVD tente de sélectionner un volume de DVD sur n’importe quel lecteur disponible. Au démarrage, dvd Navigator recherche automatiquement un lecteur, en commençant par le lecteur C, avec un dossier VIDEO_TS dans le dossier racine. Il est donc nécessaire d’appeler SetDVDDirectory uniquement lorsque vous avez plusieurs lecteurs de DVD sur un ordinateur, ou si votre lettre de lecteur de DVD est A ou B. Lorsque vous spécifiez le chemin d’accès, incluez le dossier video_ts.

C++
SetDVDDirectory(L"e:\\video_ts");

Certains volumes de DVD peuvent avoir leur vidéo dans un répertoire nommé autre chose que « video_ts ». L’idée générale est qu’un « volume DVD » supplémentaire (l’ensemble de . IFO. VOB, et . Les fichiers BUP qui seraient normalement stockés dans le répertoire VIDEO_TS) peuvent être placés dans un sous-répertoire sur le disque. En modifiant la racine pour qu’elle pointe vers ce répertoire, MSWebDVD fonctionnera sur ce volume DE DVD distinct. Un nouvel ensemble de menus, de titres, etc., sera disponible, indépendamment des titres de la racine VIDEO_TS, qui ne seront plus accessibles. Ces répertoires sont appelés « répertoires masqués ». L’exemple suivant montre comment définir un répertoire masqué comme racine, où « masqué » est un espace réservé pour n’importe quel nom que les auteurs de disque ont donné au répertoire.

C++
SetDVDDirectory(L"d:\\webdvd\\hidden");

Si le graphique de filtres est en cours d’exécution et que le Navigateur de DVD trouve un DVD dans le répertoire spécifié par pszwPath, le navigateur de DVD commence automatiquement à lire le disque. Cela est conforme à la spécification du DVD et garantit que le nouveau disque est correctement initialisé. Si vous ne souhaitez pas que le nouveau disque soit lu automatiquement après SetDVDDirectory les retours, vous devez définir l’indicateur DVD_ResetOnStop dans IDvdControl2::SetOption sur TRUE et arrêter le graphe de filtre via un appel à IMediaControl::Stop dans le Gestionnaire de graphe de filtre. Si DVD_ResetOnStop a la valeur FALSE, SetDVDDirectory retourne VFW_E_DVD_INVALIDDOMAIN.

Cette méthode est illustrée dans l’application DVDSample dans CDvdCore::SetDirectory.

Le tableau suivant indique le nom de la commande Annexe J auquel ce nom de méthode correspond et les domaines dans lesquels cette méthode est valide.

Nom de la commande Annexe J	Domaines valides
None	DVD_DOMAIN_Stop

Configuration requise

Client minimal pris en charge	Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	strmif.h (include Dshow.h)
Bibliothèque	Strmiids.lib

Voir aussi

DVD Applications

Codes d’erreur et de réussite

IDvdControl2, interface