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

Artículo
02/29/2024

El método Seek busca una posición que se usa como punto de partida mediante 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 está realizando. El parámetro fuMode debe ser uno de los siguientes modos.

Mode	Descripción
MDSP_SEEK_BOF	Busque una posición que sea unidades nOffset después del principio del archivo.
MDSP_SEEK_CUR	Busque una posición que sea nOffset unidades de la posición actual.
MDSP_SEEK_EOF	Busque una posición que sea nOffset unidades antes del final del archivo.

[in] nOffset

Número de unidades por las que la operación de búsqueda aleja la posición inicial del origen especificado por fuMode. Las unidades de nOffset se definen mediante el contenido. 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 se 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 IMDSPObjectInfo también se puede pasar para describir algún punto dentro del objeto al que apunta la interfaz especificada.

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

En el caso de la grabación del dispositivo, si no se llama a Seek antes de Grabar, se produce un error en la operación de registro. Después de llamar al método Record , las llamadas posteriores al método IMDSPObjectInfo::GetLastPlayPosition notifican la longitud total de reproducción en cualquier momento y equivalen al valor devuelto desde IMDSPObjectInfo::GetTotalLength. La longitud de la grabación se puede limitar llamando al método IMDSPObjectInfo::SetPlayLength después de volver desde la llamada Seek .