IMDSPDeviceControl ::P lay, méthode (mswmdm.h)

Article
03/06/2024

La méthode Play commence à jouer à la position de recherche actuelle. Si la méthode Seek n’a pas été appelée, la lecture commence au début du premier fichier et la longueur de lecture n’est pas définie.

Syntaxe

HRESULT Play();

Valeur de retour

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_BUSY	L’appareil est occupé.
WMDM_E_NOTSUPPORTED	La fonction play n’est pas implémentée sur cet appareil.
E_FAIL	Une erreur non spécifiée s'est produite.

Remarques

Cette méthode est utilisée pour appeler à la fois la lecture d’appareil (lecture d’une piste audio sur un support de stockage du périphérique multimédia) et la lecture audio en streaming (diffusion en continu de données audio de l’ordinateur de l’utilisateur vers le périphérique multimédia, où elles sont lues). La méthode Seek détermine la forme de lecture qui se produit.

Certains appareils ne prennent pas en charge la lecture d’appareils ou la lecture audio en continu. Avant de commencer la lecture d’un type particulier, la méthode GetCapabilities doit être appelée. Si la lecture non prise en charge est tentée, cette méthode retourne WMDM_E_NOTSUPPORTED.

Pour déterminer si un format audio peut être lu par le périphérique multimédia avant d’appeler l’opération de lecture, vous pouvez appeler la méthode IMDSPDevice ::GetFormatSupport .