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

Article
08/25/2023

La méthode GetCapabilities récupère les fonctionnalités de l’appareil pour déterminer les opérations que l’appareil peut effectuer. 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 spécifiant les fonctionnalités de l’appareil. Les indicateurs suivants peuvent être retournés dans cette variable.

Indicateur	Description
WMDM_DEVICECAP_CANPLAY	L’appareil multimédia peut lire l’audio MP3.
WMDM_DEVICECAP_CANSTREAMPLAY	L’appareil multimédia peut lire le streaming audio directement à partir de l’ordinateur hôte.
WMDM_DEVICECAP_CANRECORD	Le périphérique multimédia peut enregistrer de l’audio.
WMDM_DEVICECAP_CANSTREAMRECORD	Le périphérique multimédia peut enregistrer l’audio en streaming directement sur l’ordinateur hôte.
WMDM_DEVICECAP_CANPAUSE	L’appareil multimédia peut s’interrompre pendant les opérations de lecture ou d’enregistrement.
WMDM_DEVICECAP_CANRESUME	Le périphérique multimédia peut reprendre une opération qui a été suspendue.
WMDM_DEVICECAP_CANSTOP	Le périphérique multimédia peut arrêter la lecture avant la fin d’un fichier.
WMDM_DEVICECAP_CANSEEK	L’appareil multimédia peut rechercher une position autre que le début d’un fichier.
WMDM_DEVICECAP_HASSECURECLOCK	L’appareil multimédia dispose d’une horloge sécurisée.

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.

Remarques

Actuellement, peu d’appareils signalent correctement leurs fonctionnalités.

Exemples

Le code C++ suivant récupère les fonctionnalités de l’appareil.


// Examine the device capabilities.
// Use some of these to enable or disable the application's
// user interface elements.
CComQIPtr<IWMDMDeviceControl> pDeviceControl(pIWMDMDevice);
if (pDeviceControl != NULL)
{
    DWORD caps = 0;
    hr = pDeviceControl->GetCapabilities(&caps);
    if (caps & WMDM_DEVICECAP_CANPLAY)
    {
        // TODO: Display a message indicating that the media device can play MP3 audio.
    }
    if (caps & WMDM_DEVICECAP_CANSTREAMPLAY)
    {
        // TODO: Display a message that the device can play audio directly from the host computer.
    }
    if (caps & WMDM_DEVICECAP_CANRECORD)
    {
        // TODO: Display a message that the device can record audio.
    }
    if (caps & WMDM_DEVICECAP_CANSTREAMRECORD)
    {
        // TODO: Display a message that the media device can record 
        // streaming audio directly to the host computer.
    }
    if (caps & WMDM_DEVICECAP_CANPAUSE)
    {
        // TODO: Display a message that the device can pause during play or record operations.
    }
    if (caps & WMDM_DEVICECAP_CANRESUME)
    {
        // TODO: Display a message that the device can resume an operation that was paused.
    }
    if (caps & WMDM_DEVICECAP_CANSTOP)
    {
        // TODO: Display a message that the device can stop playing before the end of a file.
    }
    if (caps & WMDM_DEVICECAP_CANSEEK)
    {
        // TODO: Display a message that the device can seek to a position 
        // other than the beginning of the file.
    }
    if (caps & WMDM_DEVICECAP_HASSECURECLOCK)
    {
        // TODO: Display a message indicating that the device has a secure clock.
    }
}

Configuration requise

Condition requise	Valeur
Plateforme cible	Windows
En-tête	mswmdm.h
Bibliothèque	Mssachlp.lib

Voir aussi

IWMDMDeviceControl Interface

IWMDMObjectInfo Interface

Partager via