Funzione SwDeviceInterfacePropertySet (swdevice.h)

Articolo
05/03/2024

Imposta le proprietà in un'interfaccia del dispositivo software.

Sintassi

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

Parametri

[in] hSwDevice

L'handle HSWDEVICE per il dispositivo software dell'interfaccia per impostare le proprietà per.

[in] pszDeviceInterfaceId

Stringa che identifica l'interfaccia in cui impostare le proprietà.

[in] cPropertyCount

Numero di strutture DEVPROPERTY nella matrice pProperties .

[in] pProperties

Matrice di strutture DEVPROPERTY contenenti le proprietà da impostare sull'interfaccia.

Valore restituito

S_OK viene restituito se SwDeviceInterfacePropertySet imposta correttamente le proprietà nell'interfaccia; in caso contrario, un valore di errore appropriato.

Commenti

È possibile chiamare SwDeviceInterfacePropertySet solo dopo che il sistema operativo ha chiamato la funzione di callback dell'app client SW_DEVICE_CREATE_CALLBACK per notificare all'app client che l'enumerazione del dispositivo è stata completata.

Esiste una differenza sottile tra le proprietà impostate come parte di una chiamata e proprietà SwDeviceInterfaceRegister impostate in un secondo momento chiamando SwDeviceInterfacePropertySet. Le proprietà impostate come parte di SwDeviceInterfaceRegister vengono archiviate in memoria; se il dispositivo viene disinstallato o un driver Null elimina gli archivi delle proprietà, queste proprietà vengono scritte di nuovo dalla funzionalità API dispositivo software quando PnP enumera nuovamente i dispositivi. Questo è tutto trasparente per il client. Proprietà impostate usando SwDeviceInterfacePropertySet dopo l'enumerazione non vengono mantenute in memoria. Tuttavia, se si imposta una proprietà usando SwDeviceInterfaceRegister, è possibile aggiornare il valore con SwDeviceInterfacePropertySet e questo aggiornamento viene applicato al valore in memoria e all'archivio persistente.

È possibile usare SwDeviceInterfacePropertySet solo per impostare le proprietà nell'archivio del sistema operativo per l'interfaccia.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 8
Server minimo supportato	Windows Server 2012
Piattaforma di destinazione	Universale
Intestazione	swdevice.h
Libreria	Swdevice.lib; OneCoreUAP.lib in Windows 10
DLL	Cfgmgr32.dll

Condividi tramite