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 |
|---|---|
|
Operazione completata. |
|
Argomento non valido. |
|
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 |