Método IWMDMDeviceControl::Seek (mswmdm.h)

Artículo
08/25/2023

El método Seek busca una posición que se usa como punto de partida por los métodos Play o Record .

Sintaxis

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

Parámetros

[in] fuMode

Modo para la operación de búsqueda que se realiza. El parámetro fuMode debe ser uno de los modos siguientes.

Mode	Descripción
WMDM_SEEK_BEGIN	Busque una posición que sea nOffset unidades después del principio del archivo.
WMDM_SEEK_CURRENT	Busque una posición que sea nOffset unidades de la posición actual.
WMDM_SEEK_END	Busque una posición que sea nOffset unidades antes del final del archivo.
WMDM_SEEK_REMOTECONTROL	Busque el control extraíble.
WMDM_SEEK_STREAMINGAUDIO	Busque el audio de streaming.

[in] nOffset

Número de unidades por las que la operación de búsqueda mueve la posición inicial lejos del origen especificado por fuMode. El contenido define las unidades de nOffset . Pueden ser milisegundos para música, páginas para libros electrónicos, etc.

Un valor positivo para nOffset indica la búsqueda hacia delante a través del archivo. Un valor negativo indica la búsqueda hacia atrás a través del archivo. Cualquier combinación de nOffset y fuMode que indique que busca una posición antes del principio del archivo o después del final del archivo no es válida y hace que el método devuelva E_INVALIDARG.

Valor devuelto

El método devuelve un valor HRESULT. Entre los valores posibles se incluyen los que se indican en la tabla siguiente, entre otros.

Código devuelto	Descripción
S_OK	El método se ha llevado a cabo de forma correcta.
E_INVALIDARG	Uno o varios parámetros no son válidos.
WMDM_E_NOTSUPPORTED	Seek no se implementa en este dispositivo.
E_FAIL	Se ha producido un error no especificado.

Comentarios

La posición de búsqueda se define pasando una interfaz IWMDMStorage que apunta a una ubicación en un medio de almacenamiento del dispositivo o una interfaz IWMDMOperation que se ha implementado para admitir el audio de streaming. La interfaz IWMDMObjectInfo también se puede pasar para describir algún punto dentro del objeto al que apunta la interfaz especificada.

Para la reproducción del dispositivo, si no se llama a Seek antes de Reproducir, la reproducción comienza en la primera pista de audio en el primer medio de almacenamiento del dispositivo multimedia.

En el caso de la grabación del dispositivo, si no se llama a Seek antes de Record, se produce un error en la operación de registro. La longitud de la grabación se puede limitar llamando al método IWMDMObjectInfo::SetPlayLength después de volver desde la llamada a Seek .