Metodo IWMDMDeviceControl::GetCapabilities (mswmdm.h)

Articolo
03/05/2024

Il metodo GetCapabilities recupera le funzionalità del dispositivo per determinare le operazioni che il dispositivo può eseguire. Le funzionalità descrivono i metodi del controllo dispositivo supportati dal dispositivo multimediale.

Sintassi

HRESULT GetCapabilities(
  [out] DWORD *pdwCapabilitiesMask
);

Parametri

[out] pdwCapabilitiesMask

Puntatore a un DWORD che specifica le funzionalità del dispositivo. In questa variabile è possibile restituire i flag seguenti.

Flag	Descrizione
WMDM_DEVICECAP_CANPLAY	Il dispositivo multimediale può riprodurre audio MP3.
WMDM_DEVICECAP_CANSTREAMPLAY	Il dispositivo multimediale può riprodurre l'audio in streaming direttamente dal computer host.
WMDM_DEVICECAP_CANRECORD	Il dispositivo multimediale può registrare l'audio.
WMDM_DEVICECAP_CANSTREAMRECORD	Il dispositivo multimediale può registrare l'audio in streaming direttamente nel computer host.
WMDM_DEVICECAP_CANPAUSE	Il dispositivo multimediale può essere sospeso durante le operazioni di riproduzione o registrazione.
WMDM_DEVICECAP_CANRESUME	Il dispositivo multimediale può riprendere un'operazione sospesa.
WMDM_DEVICECAP_CANSTOP	Il dispositivo multimediale può interrompere la riproduzione prima della fine di un file.
WMDM_DEVICECAP_CANSEEK	Il dispositivo multimediale può cercare una posizione diversa dall'inizio di un file.
WMDM_DEVICECAP_HASSECURECLOCK	Il dispositivo multimediale ha un orologio sicuro.

Valore restituito

Il metodo restituisce un valore HRESULT. I valori possibili includono, ma non sono limitati a, quelli indicati nella tabella seguente.

Codice restituito	Descrizione
S_OK	Il metodo è riuscito.
E_INVALIDARG	Il parametro pdwCapabilitiesMask è un puntatore NULL o non valido.
E_FAIL	Si è verificato un errore non specificato.

Commenti

Attualmente, non molti dispositivi segnalano correttamente le proprie funzionalità.

Esempio

Il codice C++ seguente recupera le funzionalità del dispositivo.


// 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.
    }
}

Requisiti

Requisito	Valore
Piattaforma di destinazione	Windows
Intestazione	mswmdm.h
Libreria	Mssachlp.lib

Vedi anche

Interfaccia IWMDMDeviceControl

Interfaccia IWMDMObjectInfo

Condividi tramite