Interface IDeviceSpecificProperty (devicetopology.h)
A interface IDeviceSpecificProperty fornece acesso ao valor de controle de um controle de hardware específico do dispositivo. Um cliente obtém uma referência a uma interface IDeviceSpecificProperty de uma parte chamando o método IPart::Activate com refiid de parâmetro definido como REFIID IID_IDeviceSpecificProperty. A chamada para IPart::Activate só terá êxito se a parte der suporte à interface IDeviceSpecificProperty . Uma parte só dá suporte a essa interface se o controle de hardware subjacente tiver um valor de controle específico do dispositivo e o controle não puder ser representado adequadamente por nenhuma outra interface na API DeviceTopology.
Normalmente, uma propriedade específica do dispositivo é útil apenas para um cliente que pode inferir o significado do valor da propriedade de informações como o tipo de parte, o subtipo de parte e o nome da parte. O cliente pode obter essas informações chamando os métodos IPart::GetPartType, IPart::GetSubType e IPart::GetName .
A maioria dos drivers de adaptador de áudio do Windows dá suporte ao WDM (Modelo de Driver do Windows) e usa propriedades de KS (streaming de kernel) para representar os parâmetros de controle de hardware em subunidades (conhecidos como nós KS). A interface IDeviceSpecificProperty fornece acesso conveniente à propriedade KSPROPERTY_AUDIO_DEV_SPECIFIC de uma subunidade que tem um valor GUID de subtipo de KSNODETYPE_DEV_SPECIFIC. Para obter o GUID do subtipo de uma subunidade, chame o método IPart::GetSubType . Para obter mais informações sobre propriedades KS e tipos de nó KS, consulte a documentação do DDK do Windows.
Herança
A interface IDeviceSpecificProperty herda da interface IUnknown . IDeviceSpecificProperty também tem esses tipos de membros:
Métodos
A interface IDeviceSpecificProperty tem esses métodos.
IDeviceSpecificProperty::Get4BRange O método Get4BRange obtém o intervalo de 4 bytes do valor da propriedade específica do dispositivo. |
IDeviceSpecificProperty::GetType O método GetType obtém o tipo de dados do valor da propriedade específica do dispositivo. |
IDeviceSpecificProperty::GetValue O método GetValue obtém o valor atual da propriedade específica do dispositivo. |
IDeviceSpecificProperty::SetValue O método SetValue define o valor da propriedade específica do dispositivo. |
Requisitos
Cliente mínimo com suporte | Windows Vista [somente aplicativos da área de trabalho] |
Servidor mínimo com suporte | Windows Server 2008 [somente aplicativos da área de trabalho] |
Plataforma de Destino | Windows |
Cabeçalho | devicetopology.h |