Compartilhar via


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

Confira também

Principais interfaces de áudio

DeviceTopology API

IPart::Activate

IPart::GetName

IPart::GetPartType

IPart::GetSubType