Metodo IDeviceControl2::SetDEVICEDirectory (strmif.h)

  • Articolo

[La funzionalità associata a questa pagina, DirectShow, è una funzionalità legacy. È stata sostituita da MediaPlayer, FMMediaEngine e Audio/Video Capture in Media Foundation. Queste funzionalità sono state ottimizzate per Windows 10 e Windows 11. Microsoft consiglia vivamente che il nuovo codice usi MediaPlayer, FMMediaEngine e Audio/Video Capture in Media Foundation anziché DirectShow, quando possibile. Microsoft suggerisce che il codice esistente che usa le API legacy venga riscritto per usare le nuove API, se possibile.

Il SetDVDDirectory metodo imposta l'unità DVD da cui verrà letto il filtro navigatore DVD .

Sintassi

HRESULT SetDVDDirectory(
  [in] LPCWSTR pszwPath
);

Parametri

[in] pszwPath

Puntatore a una stringa di caratteri wide che specifica il percorso della directory radice.

Valore restituito

Restituisce uno dei valori seguenti.

Codice restituito Descrizione
S_OK
 Operazione completata.
E_INVALIDARG
 Il parametro pszwPath punta a un percorso DVD non valido oppure non viene trovata un'unità DVD durante l'enumerazione.
E_UNEXPECTED
 Il navigatore DVD non viene inizializzato.
VFW_E_DVD_INVALIDDOMAIN
 dominio non valido. Per informazioni dettagliate, vedere la sezione Osservazioni.

Commenti

Se pszwPath è NULL, lo strumento di navigazione DVD tenta di selezionare un volume DVD in qualsiasi unità disponibile. All'avvio, lo strumento di navigazione DVD cerca automaticamente un'unità, a partire dall'unità C, con una cartella VIDEO_TS nella cartella radice. È quindi necessario chiamare SetDVDDirectory solo quando si dispone di più unità DVD in un computer o se la lettera di unità DVD è A o B. Quando si specifica il percorso, includere la cartella video_ts.

C++ 
SetDVDDirectory(L"e:\\video_ts");
Alcuni volumi DVD possono avere il loro video in una directory denominata qualcosa diverso da "video_ts". L'idea generale è che un ulteriore "volume DVD" (il set di . IFO. VOB e . I file BUP che normalmente vengono archiviati nella directory VIDEO_TS) possono essere inseriti in una sottodirectory sul disco. Modificando la radice in modo che punti a questa directory, MSWeb XAML funzionerà su questo volume DVD separato. Un nuovo set di menu, titoli e così via sarà disponibile, indipendentemente dai titoli nella radice VIDEO_TS, che non sarà più accessibile. Tali directory sono denominate "directory nascoste". Nell'esempio seguente viene illustrato come impostare una directory nascosta come radice, in cui "nascosto" è un segnaposto per qualsiasi nome che gli autori del disco hanno assegnato alla directory.
C++ 
SetDVDDirectory(L"d:\\webdvd\\hidden");
Se il grafico del filtro è in esecuzione e lo strumento di navigazione DVD trova un DVD nella directory specificata da pszwPath, il navigatore DVD inizia automaticamente a riprodurre il disco. Questa operazione è conforme alla specifica DVD e garantisce che il nuovo disco venga inizializzato correttamente. Se non si vuole che il nuovo disco venga riprodotto automaticamente dopo SetDVDDirectory il ritorno, è necessario impostare il flag di DVD_ResetOnStop in IDeviceControl2::SetOption su TRUE e arrestare il grafico del filtro tramite una chiamata a IMediaControl::Stop in Filter Graph Manager. Se DVD_ResetOnStop è impostato su FALSE, restituisce SetDVDDirectory VFW_E_DVD_INVALIDDOMAIN.

Questo metodo è illustrato nell'applicazione DVDSample in CDeviceCore::SetDirectory.

Nella tabella seguente viene illustrato il nome del comando Allegato J a cui corrisponde il nome del metodo e i domini in cui questo metodo è valido.

Nome comando J allegato Domini validi
Nessuno DVD_DOMAIN_Stop

Requisiti

   
Client minimo supportato Windows XP [solo app desktop]
Server minimo supportato Windows Server 2003 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione strmif.h (include Dshow.h)
Libreria Strmiids.lib

Vedi anche

Applicazioni DVD

Codici errore e esito positivo

Interfaccia ICollectionControl2