Funzione SetupDiSetDeviceInterfacePropertyW (setupapi.h)
La funzione SetupDiSetDeviceInterfaceProperty imposta una proprietà del dispositivo di un'interfaccia del dispositivo.
Sintassi
WINSETUPAPI BOOL SetupDiSetDeviceInterfacePropertyW(
[in] HDEVINFO DeviceInfoSet,
[in] PSP_DEVICE_INTERFACE_DATA DeviceInterfaceData,
[in] const DEVPROPKEY *PropertyKey,
[in] DEVPROPTYPE PropertyType,
[in, optional] const PBYTE PropertyBuffer,
[in] DWORD PropertyBufferSize,
[in] DWORD Flags
);
Parametri
[in] DeviceInfoSet
Handle per un set di informazioni sul dispositivo che contiene l'interfaccia del dispositivo per cui impostare una proprietà dell'interfaccia del dispositivo.
[in] DeviceInterfaceData
Puntatore a una struttura SP_DEVICE_INTERFACE_DATA che rappresenta l'interfaccia del dispositivo per cui impostare una proprietà dell'interfaccia del dispositivo.
[in] PropertyKey
Puntatore a una struttura DEVPROPKEY che rappresenta la chiave della proprietà del dispositivo della proprietà dell'interfaccia del dispositivo da impostare.
[in] PropertyType
Valore tipizzato DEVPROPTYPE che rappresenta l'identificatore property-data-type della proprietà dell'interfaccia del dispositivo da impostare. Per altre informazioni sull'identificatore property-data-type, vedere la sezione Osservazioni più avanti in questo argomento.
[in, optional] PropertyBuffer
Puntatore a un buffer contenente il valore della proprietà dell'interfaccia del dispositivo. Se la proprietà o il valore dell'interfaccia viene eliminato, questo puntatore deve essere impostato su NULL e PropertyBufferSize deve essere impostato su zero. Per altre informazioni sui dati sui valori delle proprietà, vedere la sezione Osservazioni più avanti in questo argomento.
[in] PropertyBufferSize
Dimensione, in byte, del buffer PropertyBuffer . Le dimensioni del buffer delle proprietà devono essere coerenti con l'identificatore property-data-type fornito da PropertyType. Se PropertyBuffer è impostato su NULL, PropertyBufferSize deve essere impostato su zero.
[in] Flags
Deve essere impostato su zero.
Valore restituito
SetupDiSetDeviceInterfaceProperty restituisce TRUE se ha esito positivo. In caso contrario, questa funzione restituisce FALSE e l'errore registrato può essere recuperato chiamando GetLastError.
La tabella seguente include alcuni dei codici di errore più comuni che questa funzione potrebbe registrare.
| Codice restituito | Descrizione |
|---|---|
|
Il valore di Flags non è zero. |
|
Il set di informazioni sul dispositivo specificato da DevInfoSet non è valido. |
|
Un parametro specificato non è valido. Una possibilità è che l'interfaccia del dispositivo specificata da DeviceInterfaceData non sia valida. |
|
La chiave della proprietà fornita da PropertyKey non è valida. |
|
Valore dati non specificato non valido. Questo errore può essere registrato se il nome del collegamento simbolico dell'interfaccia del dispositivo non è valido o l'identificatore property-data-type non è valido. |
|
Un buffer utente non è valido. Una possibilità è che PropertyBuffer è NULL e PropertBufferSize non è zero. |
|
L'interfaccia del dispositivo specificata da DeviceInterfaceData non esiste. |
|
Un buffer di dati interno passato a una chiamata di sistema era troppo piccolo. |
|
Memoria di sistema insufficiente per completare l'operazione. |
|
Non è stato trovato un elemento interno non specificato. Una possibilità è che una proprietà da eliminare non esista. |
|
Il chiamante non dispone dei privilegi di amministratore. |
Commenti
SetupDiSetDeviceInterfaceProperty fa parte del modello di proprietà del dispositivo unificato.
SetupAPI supporta solo una versione Unicode di SetupDiSetDeviceInterfaceProperty.
Un chiamante di SetupDiSetDeviceInterfaceProperty deve essere membro del gruppo Administrators per impostare una proprietà dell'interfaccia del dispositivo.
SetupDiSetDeviceInterfaceProperty applica i requisiti per l'identificatore property-data-type e il valore della proprietà.
Per ottenere le chiavi delle proprietà del dispositivo che rappresentano le proprietà del dispositivo impostate per un'interfaccia del dispositivo, chiamare SetupDiGetDeviceInterfacePropertyKeys.
Per recuperare una proprietà dell'interfaccia del dispositivo, chiamare SetupDiGetDeviceInterfaceProperty.
Requisiti
| Client minimo supportato | Disponibile in Windows Vista e versioni successive di Windows. |
| Piattaforma di destinazione | DesktopFor universal, chiamare CM_Set_Device_Interface_Property |
| Intestazione | setupapi.h (include Setupapi.h) |
| Libreria | Setupapi.lib |