Metodo IWMDMDeviceControl::Seek (mswmdm.h)

Articolo
08/25/2023

Il metodo Seek cerca una posizione utilizzata come punto iniziale dai metodi Play o Record .

Sintassi

HRESULT Seek(
  [in] UINT fuMode,
  [in] int  nOffset
);

Parametri

[in] fuMode

Modalità per l'operazione di ricerca eseguita. Il parametro fuMode deve essere una delle modalità seguenti.

Mode	Descrizione
WMDM_SEEK_BEGIN	Cercare una posizione che sia un'unità nOffset dopo l'inizio del file.
WMDM_SEEK_CURRENT	Cercare una posizione che sia nOffset unità dalla posizione corrente.
WMDM_SEEK_END	Cercare una posizione che sia nOffset unità prima della fine del file.
WMDM_SEEK_REMOTECONTROL	Cercare il controllo rimovibile.
WMDM_SEEK_STREAMINGAUDIO	Cercare l'audio di streaming.

[in] nOffset

Numero di unità in base al quale l'operazione seek sposta la posizione iniziale dall'origine specificata da fuMode. Le unità di nOffset sono definite dal contenuto. Possono essere millisecondi per musica, pagine per libri elettronici e così via.

Un valore positivo per nOffset indica la ricerca in avanti nel file. Un valore negativo indica la ricerca all'indietro nel file. Qualsiasi combinazione di nOffset e fuMode che indica la ricerca di una posizione prima dell'inizio del file o dopo la fine del file non è valida e fa sì che il metodo restituisca E_INVALIDARG.

Valore restituito

Il metodo restituisce un valore HRESULT. I valori possibili includono, ma non sono limitati a, quelli indicati nella tabella seguente.

Codice restituito	Descrizione
S_OK	Il metodo è riuscito.
E_INVALIDARG	Uno o più parametri non sono validi.
WMDM_E_NOTSUPPORTED	La ricerca non è implementata in questo dispositivo.
E_FAIL	Si è verificato un errore non specificato.

Commenti

La posizione di ricerca viene definita passando un'interfaccia IWMDMStorage che punta a una posizione su un supporto di archiviazione del dispositivo o un'interfaccia IWMDMOperation implementata per supportare l'audio di streaming. È anche possibile passare l'interfaccia IWMDMObjectInfo per descrivere un punto all'interno dell'oggetto a cui punta l'interfaccia specificata.

Per la riproduzione del dispositivo, se Seek non viene chiamato prima di Play, la riproduzione inizia alla prima traccia audio del primo supporto di archiviazione nel dispositivo multimediale.

Per la registrazione del dispositivo, se Seek non viene chiamato prima di Record, l'operazione di record ha esito negativo. La lunghezza della registrazione può essere limitata chiamando il metodo IWMDMObjectInfo::SetPlayLength dopo la restituzione dalla chiamata Seek .