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	S_OK
E_INVALIDARG	Le paramètre pdwCapabilitiesMask est un pointeur non valide ou NULL.
E_FAIL	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

Voir aussi

IMDSPDeviceControl Interface