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

Article
08/25/2023

La méthode Seek recherche une position qui est utilisée comme point de départ par les méthodes Play ou Record .

Syntaxe

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

Paramètres

[in] fuMode

Mode pour l’opération de recherche en cours d’exécution. Le paramètre fuMode doit être l’un des modes suivants.

Mode	Description
WMDM_SEEK_BEGIN	Recherchez une position qui est nOffset units après le début du fichier.
WMDM_SEEK_CURRENT	Recherchez une position qui est nOffset units de la position actuelle.
WMDM_SEEK_END	Recherchez une position qui est nOffset units avant la fin du fichier.
WMDM_SEEK_REMOTECONTROL	Recherchez le contrôle amovible.
WMDM_SEEK_STREAMINGAUDIO	Recherchez l’audio de streaming.

[in] nOffset

Nombre d’unités par lesquelles l’opération de recherche déplace la position de départ loin de l’origine spécifiée par fuMode. Les unités de nOffset sont définies par le contenu. Ils peuvent être des millisecondes pour la musique, des pages pour des livres électroniques, et ainsi de suite.

Une valeur positive pour nOffset indique la recherche vers l’avant dans le fichier. Une valeur négative indique la recherche vers l’arrière dans le fichier. Toute combinaison de nOffset et de fuMode qui indique la recherche d’une position avant le début du fichier ou après la fin du fichier n’est pas valide et entraîne le retour de la méthode E_INVALIDARG.

Valeur retournée

Cette méthode retourne un code HRESULT. Les valeurs possibles sont notamment celles figurant dans le tableau suivant.

Code de retour	Description
S_OK	S_OK
E_INVALIDARG	Un ou plusieurs paramètres ne sont pas valides.
WMDM_E_NOTSUPPORTED	Seek n’est pas implémenté sur cet appareil.
E_FAIL	Une erreur non spécifiée s'est produite.

Notes

La position de recherche est définie en passant une interface IWMDMStorage pointant vers un emplacement sur un support de stockage de l’appareil, ou une interface IWMDMOperation qui a été implémentée pour prendre en charge la diffusion audio en continu. L’interface IWMDMObjectInfo peut également être passée pour décrire un point dans l’objet vers lequel pointe l’interface spécifiée.

Pour la lecture de l’appareil, si Seek n’est pas appelé avant Lecture, la lecture commence à la première piste audio sur le premier support de stockage sur l’appareil multimédia.

Pour l’enregistrement de l’appareil, si Seek n’est pas appelé avant l’enregistrement, l’opération d’enregistrement échoue. La longueur de l’enregistrement peut être limitée en appelant la méthode IWMDMObjectInfo::SetPlayLength après le retour de l’appel Seek .