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 |
|