Metodo IDeviceInfo2::GetState (strmif.h)

Articolo
07/28/2023

[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

Condividi tramite