Funzione SwDevicePropertySet (swdevice.h)

Articolo
05/03/2024

Imposta le proprietà in un dispositivo software.

Sintassi

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

Parametri

[in] hSwDevice

Handle HSWDEVICE per il dispositivo software per cui impostare le proprietà.

[in] cPropertyCount

Numero di strutture DEVPROPERTY nella matrice pProperties .

[in] pProperties

Matrice di strutture DEVPROPERTY contenenti le proprietà da impostare.

Valore restituito

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

Commenti

È possibile chiamare SwDevicePropertySet 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 sottile differenza tra le proprietà impostate come parte di una chiamata SwDeviceCreate e le proprietà che vengono successivamente impostate chiamando SwDevicePropertySet. Le proprietà impostate come parte di SwDeviceCreate vengono archiviate in memoria; se il dispositivo viene disinstallato o un driver Null cancella 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 SwDevicePropertySet dopo che l'enumerazione non viene mantenuta in memoria. Tuttavia, se imposti una proprietà usando SwDeviceCreate, puoi aggiornare il valore con SwDevicePropertySet e questo aggiornamento viene applicato al valore in memoria e all'archivio persistente.

È possibile usare SwDevicePropertySet solo per impostare le proprietà nell'archivio del sistema operativo per il dispositivo.

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