Interface IDeviceSpecificProperty (devicetopology.h)

Artigo
08/23/2023

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

Confira também

Principais interfaces de áudio

Share via