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

El método GetCapabilities recupera las funcionalidades del dispositivo para determinar qué operaciones puede realizar el dispositivo. Las funcionalidades describen los métodos del control de dispositivo compatibles con el dispositivo multimedia.

Sintaxis

HRESULT GetCapabilities(
  [out] DWORD *pdwCapabilitiesMask
);

Parámetros

[out] pdwCapabilitiesMask

Puntero a un DWORD que especifica las funciones del dispositivo. Las marcas siguientes se pueden devolver en esta variable.

Marca	Descripción
WMDM_DEVICECAP_CANPLAY	El dispositivo multimedia puede reproducir audio MP3.
WMDM_DEVICECAP_CANSTREAMPLAY	El dispositivo multimedia puede reproducir audio de streaming directamente desde el equipo host.
WMDM_DEVICECAP_CANRECORD	El dispositivo multimedia puede grabar audio.
WMDM_DEVICECAP_CANSTREAMRECORD	El dispositivo multimedia puede grabar audio de streaming directamente en el equipo host.
WMDM_DEVICECAP_CANPAUSE	El dispositivo multimedia puede pausar durante las operaciones de reproducción o registro.
WMDM_DEVICECAP_CANRESUME	El dispositivo multimedia puede reanudar una operación que se ha pausado.
WMDM_DEVICECAP_CANSTOP	El dispositivo multimedia puede dejar de reproducirse antes del final de un archivo.
WMDM_DEVICECAP_CANSEEK	El dispositivo multimedia puede buscar una posición distinta del principio de un archivo.
WMDM_DEVICECAP_HASSECURECLOCK	El dispositivo multimedia tiene un reloj seguro.

Valor devuelto

El método devuelve un valor HRESULT. Entre los valores posibles se incluyen los que se indican en la tabla siguiente, entre otros.

Código devuelto	Descripción
S_OK	El método se ha llevado a cabo de forma correcta.
E_INVALIDARG	El parámetro pdwCapabilitiesMask es un puntero no válido o NULL .
E_FAIL	Se ha producido un error no especificado.

Comentarios

Actualmente, no muchos dispositivos notifican sus funcionalidades correctamente.

Ejemplos

El código de C++ siguiente recupera las funcionalidades 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.
    }
}

Requisitos

Requisito	Value
Plataforma de destino	Windows
Encabezado	mswmdm.h
Library	Mssachlp.lib

Consulte también

IWMDMDeviceControl (Interfaz)

Interfaz IWMDMObjectInfo