Metodo IConfigurationInfo2::GetCurrentLocation (strmif.h)

[La funzionalità associata a questa pagina, DirectShow, è una funzionalità legacy. È stata sostituita da MediaPlayer, IMFMediaEngine 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, IMFMediaEngine e Audio/Video Capture in Media Foundation invece di DirectShow, quando possibile. Microsoft suggerisce che il codice esistente che usa le API legacy venga riscritto per usare le nuove API, se possibile.

Il GetCurrentLocation metodo recupera il percorso di riproduzione corrente.

Sintassi

HRESULT GetCurrentLocation(
  [out] DVD_PLAYBACK_LOCATION2 *pLocation
);

Parametri

[out] pLocation

Puntatore a una variabile di tipo DVD_PLAYBACK_LOCATION2 che riceve le informazioni sulla posizione di riproduzione.

Valore restituito

Restituisce uno dei valori HRESULT seguenti.

Codice restituito Descrizione
S_OK
Operazione completata.
E_INVALIDARG
Argomento non valido.
E_POINTER
Il parametro pLocation non è valido.
VFW_E_DVD_INVALIDDOMAIN
Lo strumento di navigazione DVD si trova in un dominio non valido.

Commenti

Questo metodo recupera informazioni sufficienti per riavviare la riproduzione di un video dalla posizione di riproduzione corrente nei titoli che non disabilitano in modo esplicito la ricerca nella posizione corrente. Dopo aver inserito il disco, le informazioni restituite da questo metodo non saranno necessariamente sufficienti per riavviare la riproduzione. Per salvare la posizione corrente e le informazioni sullo stato su disco in modo che l'utente possa tornare alla stessa posizione in un secondo momento, usare GetState.

Requisiti

Requisito Valore
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 di errore e di esito positivo

Interfaccia IInfo2