Funzione SetupDiGetDeviceRegistryPropertyW (setupapi.h)
La funzione SetupDiGetDeviceRegistryProperty recupera una proprietà del dispositivo specificata Plug and Play.
Sintassi
WINSETUPAPI BOOL SetupDiGetDeviceRegistryPropertyW(
[in] HDEVINFO DeviceInfoSet,
[in] PSP_DEVINFO_DATA DeviceInfoData,
[in] DWORD Property,
[out, optional] PDWORD PropertyRegDataType,
[out, optional] PBYTE PropertyBuffer,
[in] DWORD PropertyBufferSize,
[out, optional] PDWORD RequiredSize
);
Parametri
[in] DeviceInfoSet
Handle a un set di informazioni sul dispositivo che contiene un elemento informativo del dispositivo che rappresenta il dispositivo per cui recuperare una proprietà Plug and Play.
[in] DeviceInfoData
Puntatore a una struttura SP_DEVINFO_DATA che specifica l'elemento informazioni sul dispositivo in DeviceInfoSet.
[in] Property
Uno dei valori seguenti che specifica la proprietà da recuperare:
SPDRP_ADDRESS
La funzione recupera l'indirizzo del dispositivo.
SPDRP_BUSNUMBER
La funzione recupera il numero del bus del dispositivo.
SPDRP_BUSTYPEGUID
La funzione recupera il GUID per il tipo di bus del dispositivo.
SPDRP_CAPABILITIES
La funzione recupera un OR bit per bit dei flag di CM_DEVCAP_Xxx seguenti in un DWORD. Le funzionalità del dispositivo rappresentate da questi flag corrispondono alle funzionalità del dispositivo rappresentate dai membri della struttura DEVICE_CAPABILITIES. Le costanti CM_DEVCAP_Xxx sono definite in Cfgmgr32.h.
| flag CM_DEVCAP_Xxx | Membro della struttura DEVICE_CAPABILITIES corrispondente |
|---|---|
| CM_DEVCAP_LOCKSUPPORTED | LockSupported |
| CM_DEVCAP_EJECTSUPPORTED | EjectSupported |
| CM_DEVCAP_REMOVABLE | Rimovibile |
| CM_DEVCAP_DOCKDEVICE | DockDevice |
| CM_DEVCAP_UNIQUEID | Uniqueid |
| CM_DEVCAP_SILENTINSTALL | SilentInstall |
| CM_DEVCAP_RAWDEVICEOK | RawDeviceOK |
| CM_DEVCAP_SURPRISEREMOVALOK | SorpresaRemovalOK |
| CM_DEVCAP_HARDWAREDISABLED | HardwareDisabled |
| CM_DEVCAP_NONDYNAMIC | NonDynamic |
SPDRP_CHARACTERISTICS
La funzione recupera un OR bit per bit dei flag delle caratteristiche di un dispositivo in una DWORD. Per una descrizione di questi flag, definiti in Wdm.h e Ntddk.h, vedere il parametro DeviceCharacteristics della funzione IoCreateDevice .
SPDRP_CLASS
La funzione recupera una stringa REG_SZ contenente la classe di installazione del dispositivo di un dispositivo.
SPDRP_CLASSGUID
La funzione recupera una stringa REG_SZ contenente il GUID che rappresenta la classe di installazione del dispositivo di un dispositivo.
SPDRP_COMPATIBLEIDS
La funzione recupera una stringa REG_MULTI_SZ contenente l'elenco di ID compatibili per un dispositivo. Per informazioni sugli ID compatibili, vedere Stringhe di identificazione del dispositivo.
SPDRP_CONFIGFLAGS
La funzione recupera un OR bit per bit dei flag di configurazione di un dispositivo in un valore DWORD. I flag di configurazione sono rappresentati daimask CONFIGFLAG_Xxx definiti in Regstr.h.
SPDRP_DEVICE_POWER_DATA
(Windows XP e versioni successive) La funzione recupera una struttura CM_POWER_DATA che contiene le informazioni di risparmio energia del dispositivo.
SPDRP_DEVICEDESC
La funzione recupera una stringa REG_SZ contenente la descrizione di un dispositivo.
SPDRP_DEVTYPE
La funzione recupera un valore DWORD che rappresenta il tipo del dispositivo. Per altre informazioni, vedere Specifica dei tipi di dispositivo.
SPDRP_DRIVER
La funzione recupera una stringa che identifica la chiave software del dispositivo (a volte denominata chiave driver). Per altre informazioni sulle chiavi del driver, vedere Alberi e chiavi del Registro di sistema per dispositivi e driver.
SPDRP_ENUMERATOR_NAME
La funzione recupera una stringa REG_SZ contenente il nome dell'enumeratore del dispositivo.
SPDRP_EXCLUSIVE
La funzione recupera un valore DWORD che indica se un utente può ottenere l'uso esclusivo del dispositivo. Il valore restituito è uno se l'uso esclusivo è consentito o zero in caso contrario. Per altre informazioni, vedere IoCreateDevice.
SPDRP_FRIENDLYNAME
La funzione recupera una stringa REG_SZ contenente il nome descrittivo di un dispositivo.
SPDRP_HARDWAREID
La funzione recupera una stringa REG_MULTI_SZ che contiene l'elenco di ID hardware per un dispositivo. Per informazioni sugli ID hardware, vedere Stringhe di identificazione del dispositivo.
SPDRP_INSTALL_STATE
(Windows XP e versioni successive) La funzione recupera un valore DWORD che indica lo stato di installazione di un dispositivo. Lo stato di installazione è rappresentato da uno dei valori CM_INSTALL_STATE_Xxx definiti in Cfgmgr32.h. I valori CM_INSTALL_STATE_Xxx corrispondono ai valori di enumerazione DEVICE_INSTALL_STATE .
SPDRP_LEGACYBUSTYPE
La funzione recupera il tipo di bus legacy del dispositivo come valore INTERFACE_TYPE (definito in Wdm.h e Ntddk.h).
SPDRP_LOCATION_INFORMATION
La funzione recupera una stringa REG_SZ che contiene la posizione hardware di un dispositivo.
SPDRP_LOCATION_PATHS
(Windows Server 2003 e versioni successive) La funzione recupera una stringa REG_MULTI_SZ che rappresenta la posizione del dispositivo nell'albero del dispositivo.
SPDRP_LOWERFILTERS
La funzione recupera una stringa REG_MULTI_SZ che contiene i nomi dei driver di filtro inferiore di un dispositivo.
SPDRP_MFG
La funzione recupera una stringa REG_SZ contenente il nome del produttore del dispositivo.
SPDRP_PHYSICAL_DEVICE_OBJECT_NAME
La funzione recupera una stringa REG_SZ contenente il nome associato al PDO del dispositivo. Per altre informazioni, vedere IoCreateDevice.
SPDRP_REMOVAL_POLICY
(Windows XP e versioni successive) La funzione recupera i criteri di rimozione correnti del dispositivo come DWORD che contiene uno dei valori CM_REMOVAL_POLICY_Xxx definiti in Cfgmgr32.h.
SPDRP_REMOVAL_POLICY_HW_DEFAULT
(Windows XP e versioni successive) La funzione recupera i criteri di rimozione predefiniti specificati dall'hardware del dispositivo come DWORD che contiene uno dei valori CM_REMOVAL_POLICY_Xxx definiti in Cfgmgr32.h.
SPDRP_REMOVAL_POLICY_OVERRIDE
(Windows XP e versioni successive) La funzione recupera i criteri di rimozione dell'override del dispositivo (se esistente) dal Registro di sistema, come DWORD che contiene uno dei valori CM_REMOVAL_POLICY_Xxx definiti in Cfgmgr32.h.
SPDRP_SECURITY
La funzione recupera una struttura SECURITY_DESCRIPTOR per un dispositivo.
SPDRP_SECURITY_SDS
La funzione recupera una stringa REG_SZ che contiene il descrittore di sicurezza del dispositivo. Per informazioni sulle stringhe del descrittore di sicurezza, vedere Security Descriptor Definition Language (Windows). Per informazioni sul formato delle stringhe del descrittore di sicurezza, vedere Security Descriptor Definition Language (Windows).
SPDRP_SERVICE
La funzione recupera una stringa REG_SZ che contiene il nome del servizio per un dispositivo.
SPDRP_UI_NUMBER
La funzione recupera un valore DWORD impostato sul valore del membro UINumber della struttura DEVICE_CAPABILITIES del dispositivo.
SPDRP_UI_NUMBER_DESC_FORMAT
La funzione recupera una stringa di formato (REG_SZ) usata per visualizzare il valore UINumber .
SPDRP_UPPERFILTERS
La funzione recupera una stringa REG_MULTI_SZ che contiene i nomi dei driver di filtro superiore di un dispositivo.
[out, optional] PropertyRegDataType
Puntatore a una variabile che riceve il tipo di dati della proprietà recuperata. Si tratta di uno dei tipi di dati del Registro di sistema standard. Questo parametro è facoltativo e può essere NULL.
[out, optional] PropertyBuffer
Puntatore a un buffer che riceve la proprietà che viene recuperata. Se questo parametro è impostato su NULL e PropertyBufferSize è impostato anche su zero, la funzione restituisce le dimensioni necessarie per il buffer in RequiredSize.
[in] PropertyBufferSize
Dimensione, in byte, del buffer PropertyBuffer .
[out, optional] RequiredSize
Puntatore a una variabile di tipo DWORD che riceve le dimensioni richieste, in byte, del buffer PropertyBuffer necessario per contenere i dati per la proprietà richiesta. Questo parametro è facoltativo e può essere NULL.
Valore restituito
SetupDiGetDeviceRegistryProperty restituisce TRUE se la chiamata ha avuto esito positivo. In caso contrario, restituisce FALSE e l'errore registrato può essere recuperato effettuando una chiamata a GetLastError. SetupDiGetDeviceRegistryProperty restituisce il codice di errore ERROR_INVALID_DATA se la proprietà richiesta non esiste per un dispositivo o se i dati della proprietà non sono validi.
Commenti
Nota
L'intestazione setupapi.h definisce SetupDiGetDeviceRegistryProperty come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice che non è indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzioni.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Disponibile in Microsoft Windows 2000 e versioni successive di Windows. |
| Piattaforma di destinazione | DesktopFor universal, chiamare CM_Get_DevNode_Registry_Property |
| Intestazione | setupapi.h (include Setupapi.h) |
| Libreria | Setupapi.lib |
Vedi anche
SetupDiGetClassRegistryProperty