comando MCI_SEEK

El comando MCI_SEEK cambia la posición actual en el contenido lo antes posible. La salida de vídeo y audio se deshabilita durante la búsqueda. Una vez completada la búsqueda, el dispositivo se detiene. Los dispositivos cd audio, digital-video, secuenciador MIDI, VCR, videodisc y audio de forma de onda reconocen este comando.

Para enviar este comando, llame a la función mciSendCommand con los parámetros siguientes.

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

Parámetros

wDeviceID

Identificador de dispositivo del dispositivo MCI que va a recibir el mensaje de comando.

dwFlags

MCI_NOTIFY, MCI_WAIT o, para dispositivos de vídeo digital y VCR, MCI_TEST. Para obtener información sobre estas marcas, vea Las marcas Wait, Notify y Test.

lpSeek

Puntero a una estructura de MCI_SEEK_PARMS . (Los dispositivos con conjuntos de comandos extendidos pueden reemplazar esta estructura por una estructura específica del dispositivo).

Valor devuelto

Devuelve cero si es correcto o si se produce un error en caso contrario.

Comentarios

Si un tamaño de muestra de datos para un dispositivo es mayor que 1 byte (por ejemplo, con datos estéreo de audio de forma de onda), este comando se mueve al principio de la muestra más cercana cuando una posición especificada no coincide con el inicio de una muestra.

Las siguientes marcas adicionales se aplican a todos los dispositivos que admiten MCI_SEEK:

MCI_SEEK_TO_END

Busque al final del contenido.

MCI_SEEK_TO_START

Busque el principio del contenido.

MCI_TO

Una posición se incluye en el miembro dwTo de la estructura identificada por lpSeek. Las unidades asignadas a los valores de posición se especifican con la marca MCI_SET_TIME_FORMAT del comando MCI_SET . No use esta marca con MCI_SEEK_TO_END o MCI_SEEK_TO_START.

Las siguientes marcas adicionales se usan con el tipo de dispositivo vcr :

MCI_VCR_SEEK_AT

El miembro dwAt de la estructura identificada por lpSeek contiene una hora en que comienza todo el comando.

MCI_VCR_SEEK_MARK

El miembro dwMark de la estructura identificada por lpSeek contiene la marca numerada que se va a buscar.

MCI_VCR_SEEK_REVERSE

La dirección de búsqueda es inversa; se usa solo con la marca MCI_VCR_SEEK_MARK.

En el caso de los dispositivos VCR, el parámetro lpSeek apunta a una estructura de MCI_VCR_SEEK_PARMS .

La siguiente marca adicional se usa con el tipo de dispositivo videodisc :

MCI_VD_SEEK_REVERSE

La dirección de búsqueda es inversa.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Encabezado	Mmsystem.h (incluya Windows.h)

Consulte también

MCI

Comandos MCI