Interfaz IDeviceSpecificProperty (devicetopology.h)

Artículo
08/23/2023

La interfaz IDeviceSpecificProperty proporciona acceso al valor de control de un control de hardware específico del dispositivo. Un cliente obtiene una referencia a una interfaz IDeviceSpecificProperty de un elemento mediante una llamada al método IPart::Activate con el parámetro refiid establecido en REFIID IID_IDeviceSpecificProperty. La llamada a IPart::Activate solo se realiza correctamente si la parte admite la interfaz IDeviceSpecificProperty . Un elemento solo admite esta interfaz si el control de hardware subyacente tiene un valor de control específico del dispositivo y el control no se puede representar adecuadamente mediante ninguna otra interfaz de la API DeviceTopology.

Normalmente, una propiedad específica del dispositivo solo es útil para un cliente que puede deducir el significado del valor de propiedad a partir de información como el tipo de elemento, el subtipo de elemento y el nombre del elemento. El cliente puede obtener esta información llamando a los métodos IPart::GetPartType, IPart::GetSubType e IPart::GetName .

La mayoría de los controladores de adaptador de audio de Windows admiten el modelo de controlador de Windows (WDM) y usan propiedades de streaming de kernel (KS) para representar los parámetros de control de hardware en subunits (denominados nodos KS). La interfaz IDeviceSpecificProperty proporciona un acceso cómodo a la propiedad KSPROPERTY_AUDIO_DEV_SPECIFIC de una subunidad que tiene un valor GUID de subtipo de KSNODETYPE_DEV_SPECIFIC. Para obtener el GUID de subtipo de una subunidad, llame al método IPart::GetSubType . Para obtener más información sobre las propiedades KS y los tipos de nodo KS, consulte la documentación de Windows DDK.

Herencia

La interfaz IDeviceSpecificProperty hereda de la interfaz IUnknown . IDeviceSpecificProperty también tiene estos tipos de miembros:

Métodos

La interfaz IDeviceSpecificProperty tiene estos métodos.


IDeviceSpecificProperty::Get4BRange El método Get4BRange obtiene el intervalo de 4 bytes del valor de propiedad específico del dispositivo.
IDeviceSpecificProperty::GetType El método GetType obtiene el tipo de datos del valor de propiedad específico del dispositivo.
IDeviceSpecificProperty::GetValue El método GetValue obtiene el valor actual de la propiedad específica del dispositivo.
IDeviceSpecificProperty::SetValue El método SetValue establece el valor de la propiedad específica del dispositivo.

Requisitos


Cliente mínimo compatible	Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	devicetopology.h

Consulte también

Interfaces de audio principales

Share via