Compartilhar via

Função SwDevicePropertySet (swdevice.h)

  • Artigo

Define propriedades em um dispositivo de software.

Sintaxe

HRESULT SwDevicePropertySet(
  [in] HSWDEVICE         hSwDevice,
  [in] ULONG             cPropertyCount,
  [in] const DEVPROPERTY *pProperties
);

Parâmetros

[in] hSwDevice

O identificador HSWDEVICE para o dispositivo de software para o qual definir as propriedades.

[in] cPropertyCount

O número de estruturas DEVPROPERTY na matriz pProperties .

[in] pProperties

Uma matriz de estruturas DEVPROPERTY que contêm as propriedades a serem definidas.

Retornar valor

S_OK será retornado se SwDevicePropertySet definir com êxito as propriedades; caso contrário, um valor de erro apropriado.

Comentários

Você pode chamar SwDevicePropertySet somente depois que o sistema operacional tiver chamado a função de retorno de chamada SW_DEVICE_CREATE_CALLBACK do aplicativo cliente para notificar o aplicativo cliente de que a enumeração do dispositivo foi concluída.

Há uma diferença sutil entre as propriedades que são definidas como parte de uma chamada SwDeviceCreate e propriedades que são definidas posteriormente chamando SwDevicePropertySet. As propriedades definidas como parte do SwDeviceCreate são armazenadas na memória; se o dispositivo estiver desinstalado ou um driver nulo apagar os repositórios de propriedades, essas propriedades serão gravadas novamente pelo recurso de API do Dispositivo de Software quando o PnP renumerar os dispositivos. Tudo isso é transparente para o cliente. As propriedades definidas usando SwDevicePropertySet após a enumeração não persistem na memória. Mas, se você definir uma propriedade usando SwDeviceCreate, poderá atualizar o valor com SwDevicePropertySet e essa atualização será aplicada ao valor na memória, bem como ao repositório persistente.

Você pode usar SwDevicePropertySet apenas para definir propriedades no repositório do sistema operacional para o dispositivo.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 8
Servidor mínimo com suporte Windows Server 2012
Plataforma de Destino Universal
Cabeçalho swdevice.h
Biblioteca Swdevice.lib; OneCoreUAP.lib no Windows 10
DLL Cfgmgr32.dll