Metodo IDeviceInfo2::GetState (strmif.h)

[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 GetState metodo recupera un segnalibro contenente la posizione del disco e le informazioni sullo stato di Navigazione DVD.

Sintassi

HRESULT GetState(
  [out] IDvdState **pStateData
);

Parametri

[out] pStateData

Riceve un puntatore all'interfaccia I MdfState di un oggetto DvdState allocato dal navigatore DVD.

Valore restituito

Restituisce uno dei valori HRESULT seguenti.

Codice restituito Descrizione
S_OK
Operazione completata.
E_INVALIDARG
Argomento non valido.
E_UNEXPECTED
Lo strumento di navigazione DVD non viene inizializzato.

Commenti

Quando viene chiamato questo metodo, lo strumento di navigazione DVD crea un nuovo oggetto stato e salva la posizione corrente in esso, nonché il livello genitori corrente e altre informazioni sullo stato. L'oggetto DVDState può essere usato per ripristinare il navigatore DVD nella posizione salvata in un secondo momento tramite una chiamata a IDeviceControl2::SetState. Ciò consente ai visualizzatori di interrompere la visualizzazione al centro di un disco, salvare la posizione e tornare in un secondo momento per iniziare a visualizzare dove hanno lasciato, con tutte le impostazioni interne ripristinate come erano prima.

Lo strumento di navigazione DVD chiama AddRef nell'oggetto DvdState prima di restituirlo all'applicazione. L'applicazione deve chiamare Release sull'oggetto al termine dell'applicazione.

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

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 IInfo2