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

Artigo
08/25/2023

O método Seek busca uma posição que é usada como ponto de partida pelos métodos Play ou Record .

Sintaxe

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

Parâmetros

[in] fuMode

Modo para a operação de busca que está sendo executada. O parâmetro fuMode deve ser um dos modos a seguir.

Mode	Descrição
MDSP_SEEK_BOF	Procure uma posição que seja nOffset unidades após o início do arquivo.
MDSP_SEEK_CUR	Busque uma posição que seja nOffset unidades da posição atual.
MDSP_SEEK_EOF	Procure uma posição que seja nOffset unidades antes do final do arquivo.

[in] nOffset

Número de unidades pelas quais a operação de busca move a posição inicial para longe da origem especificada por fuMode. As unidades de nOffset são definidas pelo conteúdo. Eles podem ser milissegundos para música, páginas para livros eletrônicos e assim por diante.

Um valor positivo para nOffset indica a busca por encaminhamento por meio do arquivo. Um valor negativo indica a busca de versões anteriores por meio do arquivo. Qualquer combinação de nOffset e fuMode que indica a busca de uma posição antes do início do arquivo ou após o fim do arquivo não é válida e faz com que o método retorne E_INVALIDARG.

Retornar valor

O método retorna um HRESULT. Os possíveis valores incluem, mas sem limitação, aqueles na tabela a seguir.

Código de retorno	Descrição
S_OK	O método foi bem-sucedido.
E_INVALIDARG	Um ou mais parâmetros são inválidos.
WMDM_E_NOTSUPPORTED	O Seek não é implementado neste dispositivo.
E_FAIL	Ocorreu um erro não especificado.

Comentários

A posição de busca é definida passando uma interface IWMDMStorage apontando para um local em um meio de armazenamento do dispositivo ou uma interface IWMDMOperation que foi implementada para dar suporte ao streaming de áudio. A interface IMDSPObjectInfo também pode ser passada para descrever algum ponto dentro do objeto para o qual a interface especificada aponta.

Para reprodução de dispositivo, se Seek não for chamado antes de Reproduzir, a reprodução será iniciada na primeira faixa de áudio na primeira mídia de armazenamento no dispositivo de mídia.

Para gravação de dispositivo, se Seek não for chamado antes de Gravar, a operação de registro falhará. Depois que o método Record é chamado, chamadas subsequentes para o método IMDSPObjectInfo::GetLastPlayPosition relatam o comprimento total da reprodução a qualquer momento e igual ao valor retornado de IMDSPObjectInfo::GetTotalLength. O comprimento da gravação pode ser limitado chamando o método IMDSPObjectInfo::SetPlayLength depois de retornar da chamada Seek .