comando MCI_SEEK

Il comando MCI_SEEK modifica la posizione corrente nel contenuto il più rapidamente possibile. L'output video e audio sono disabilitati durante la ricerca. Al termine della ricerca, il dispositivo viene arrestato. Audio CD, digital-video, sequencer MIDI, VCR, videodisc e dispositivi waveform-audio riconoscono questo comando.

Per inviare questo comando, chiamare la funzione mciSendCommand con i parametri seguenti.

MCIERROR mciSendCommand(
  MCIDEVICEID wDeviceID, 
  MCI_SEEK, 
  DWORD dwFlags, 
  (DWORD) (LPMCI_SEEK_PARMS) lpSeek
);

Parametri

wDeviceID

Identificatore del dispositivo MCI che deve ricevere il messaggio di comando.

Dwflags

MCI_NOTIFY, MCI_WAIT o, per i dispositivi digital-video e VCR, MCI_TEST. Per informazioni su questi flag, vedere Il flag Wait, Notify e Test Flag.

lpSeek

Puntatore a una struttura MCI_SEEK_PARMS . I dispositivi con set di comandi estesi potrebbero sostituire questa struttura con una struttura specifica del dispositivo.

Valore restituito

Restituisce zero se ha esito positivo o un errore in caso contrario.

Commenti

Se una dimensione di esempio di dati per un dispositivo è maggiore di 1 byte (ad esempio con dati stereo audio a forma di onda), questo comando passa all'inizio dell'esempio più vicino quando una posizione specificata non coincide con l'inizio di un campione.

I flag aggiuntivi seguenti si applicano a tutti i dispositivi che supportano MCI_SEEK:

MCI_SEEK_TO_END

Cercare la fine del contenuto.

MCI_SEEK_TO_START

Cercare l'inizio del contenuto.

MCI_TO

Una posizione è inclusa nel membro dwTo della struttura identificata da lpSeek. Le unità assegnate ai valori di posizione vengono specificate con il flag MCI_SET_TIME_FORMAT del comando MCI_SET . Non usare questo flag con MCI_SEEK_TO_END o MCI_SEEK_TO_START.

I flag aggiuntivi seguenti vengono usati con il tipo di dispositivo vcr :

MCI_VCR_SEEK_AT

Il membro dwAt della struttura identificata da lpSeek contiene un'ora in cui inizia l'intero comando.

MCI_VCR_SEEK_MARK

Il membro dwMark della struttura identificata da lpSeek contiene il contrassegno numerato da cercare.

MCI_VCR_SEEK_REVERSE

La direzione di ricerca è inversa; viene usato solo con il flag di MCI_VCR_SEEK_MARK.

Per i dispositivi VCR, il parametro lpSeek punta a una struttura MCI_VCR_SEEK_PARMS .

Il flag aggiuntivo seguente viene usato con il tipo di dispositivo di individuazione video :

MCI_VD_SEEK_REVERSE

La direzione di ricerca è inversa.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Intestazione	Mmsystem.h (include Windows.h)

Vedi anche

MCI

Comandi MCI