MÉTHODE IMDSPDeviceControl ::GetCapabilities (mswmdm.h)
La méthode GetCapabilities récupère le masque de fonctionnalités de l’appareil auquel cette interface de contrôle est associée. Les fonctionnalités décrivent les méthodes du contrôle d’appareil prises en charge par l’appareil multimédia.
Syntaxe
HRESULT GetCapabilities(
[out] DWORD *pdwCapabilitiesMask
);
Paramètres
[out] pdwCapabilitiesMask
Pointeur vers un DWORD contenant les fonctionnalités de l’appareil. Les indicateurs suivants peuvent être retournés dans cette variable.
| Indicateur | Description |
|---|---|
| MDM_DEVICECAP_CANPLAY | L’appareil multimédia peut lire l’audio MP3. |
| MDM_DEVICECAP_CANSTREAMPLAY | L’appareil multimédia peut lire le streaming audio directement à partir de l’ordinateur hôte. |
| MDM_DEVICECAP_CANRECORD | Le périphérique multimédia peut enregistrer de l’audio. |
| MDM_DEVICECAP_CANSTREAMRECORD | Le périphérique multimédia peut enregistrer l’audio en streaming directement sur l’ordinateur hôte. |
| MDM_DEVICECAP_CANPAUSE | L’appareil multimédia peut s’interrompre pendant les opérations de lecture ou d’enregistrement. |
| MDM_DEVICECAP_CANRESUME | Le périphérique multimédia peut reprendre une opération à partir d’une commande de pause. |
| MDM_DEVICECAP_CANSTOP | Le périphérique multimédia peut arrêter la lecture avant la fin d’un fichier. |
| MDM_DEVICECAP_CANSEEK | L’appareil multimédia peut rechercher une position autre que le début d’un fichier. |
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 |
|
Le paramètre pdwCapabilitiesMask est un pointeur non valide ou NULL. |
|
Une erreur non spécifiée s'est produite. |
Configuration requise
| Condition requise | Valeur |
|---|---|
| Plateforme cible | Windows |
| En-tête | mswmdm.h |
| Bibliothèque | Mssachlp.lib |