Metodo IMDSPDeviceControl::Seek (mswmdm.h)

Articolo
02/29/2024

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

Sintassi

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

Parametri

[in] fuMode

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

Mode	Descrizione
MDSP_SEEK_BOF	Cercare una posizione che corrisponde a unità nOffset dopo l'inizio del file.
MDSP_SEEK_CUR	Cercare una posizione che corrisponde a unità nOffset dalla posizione corrente.
MDSP_SEEK_EOF	Cercare una posizione che è nOffset unità prima della fine del file.

[in] nOffset

Numero di unità in base alla quale l'operazione di ricerca 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 tramite il file. Un valore negativo indica la ricerca 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 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 viene 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. L'interfaccia IMDSPObjectInfo può essere passata anche per descrivere alcuni punti 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. Dopo aver chiamato il metodo Record , le chiamate successive al metodo IMDSPObjectInfo::GetLastPlayPosition segnalano la lunghezza totale di riproduzione in qualsiasi momento e uguale al valore restituito da IMDSPObjectInfo::GetTotalLength. La lunghezza della registrazione può essere limitata chiamando il metodo IMDSPObjectInfo::SetPlayLength dopo aver restituito dalla chiamata Seek .