IMDSPDeviceControl::Seek, méthode (mswmdm.h)
La méthode Seek recherche une position 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 de l’opération de recherche en cours d’exécution. Le paramètre fuMode doit être l’un des modes suivants.
| Mode | Description |
|---|---|
| MDSP_SEEK_BOF | Recherchez une position qui est nOffset unités après le début du fichier. |
| MDSP_SEEK_CUR | Recherchez une position qui est des unités nOffset de la position actuelle. |
| MDSP_SEEK_EOF | Recherchez une position qui est des unités nOffset avant la fin du fichier. |
[in] nOffset
Nombre d’unités par lesquelles l’opération de recherche déplace la position de départ à l’écart de l’origine spécifiée par fuMode. Les unités de nOffset sont définies par le contenu. Il peut s’agir de millisecondes pour la musique, les pages de 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 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 provoque 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 |
|
Un ou plusieurs paramètres ne sont pas valides. |
|
Seek n’est pas implémenté sur cet appareil. |
|
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 implémentée pour prendre en charge l’audio en streaming. L’interface IMDSPObjectInfo peut également être passée pour décrire un point dans l’objet auquel les points d’interface spécifiés.
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. Une fois la méthode Record appelée, les appels suivants à la méthode IMDSPObjectInfo::GetLastPlayPosition signalent la longueur totale de lecture à tout moment et égaux à la valeur retournée par IMDSPObjectInfo::GetTotalLength. La longueur de l’enregistrement peut être limitée en appelant la méthode IMDSPObjectInfo::SetPlayLength après le retour de l’appel Seek .
Configuration requise
| Plateforme cible | Windows |
| En-tête | mswmdm.h |
| Bibliothèque | Mssachlp.lib |