Compartilhar via

Função SwDeviceInterfacePropertySet (swdevice.h)

  • Artigo

Define propriedades em uma interface de dispositivo de software.

Sintaxe

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

Parâmetros

[in] hSwDevice

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

[in] pszDeviceInterfaceId

Uma cadeia de caracteres que identifica a interface na 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 na interface.

Retornar valor

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

Comentários

Você pode chamar SwDeviceInterfacePropertySet 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 propriedades que são definidas como parte de uma chamada SwDeviceInterfaceRegister e propriedades que são definidas posteriormente chamando SwDeviceInterfacePropertySet. As propriedades definidas como parte de SwDeviceInterfaceRegister 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. Propriedades definidas usando SwDeviceInterfacePropertySet após a enumeração não persistirem na memória. Porém, se você definir uma propriedade usando SwDeviceInterfaceRegister, poderá atualizar o valor com SwDeviceInterfacePropertySet e essa atualização será aplicada ao valor na memória, bem como ao repositório persistente.

Você pode usar SwDeviceInterfacePropertySet apenas para definir propriedades no repositório do sistema operacional para a interface.

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