Funzione SetupDiGetDeviceRegistryPropertyA (setupapi.h)
La funzione SetupDiGetDeviceRegistryProperty
Sintassi
WINSETUPAPI BOOL SetupDiGetDeviceRegistryPropertyA(
[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 per un set di informazioni sul dispositivo che contiene un elemento di informazioni sul dispositivo che rappresenta il dispositivo per il quale recuperare una proprietà Plug and Play.
[in] DeviceInfoData
Puntatore a una struttura di 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 dell'autobus 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 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 | SurpriseRemovalOK |
| 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 di REG_SZ che contiene la classe di installazione del dispositivo di un dispositivo.
SPDRP_CLASSGUID
La funzione recupera una stringa REG_SZ che contiene il GUID che rappresenta la classe di installazione del dispositivo di un dispositivo.
SPDRP_COMPATIBLEIDS
La funzione recupera una stringa REG_MULTI_SZ che contiene l'elenco di ID compatibili per un dispositivo. Per informazioni sugli ID compatibili, vedere stringhe di identificazione dei dispositivi .
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 dalle CONFIGFLAG_
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 che contiene 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 l'chiave software del dispositivo (talvolta denominata chiave del 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 che contiene 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 oppure zero in caso contrario. Per altre informazioni, vedere IoCreateDevice.
SPDRP_FRIENDLYNAME
La funzione recupera una stringa REG_SZ che contiene 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 dei dispositivi .
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_
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 che contiene il nome del produttore del dispositivo.
SPDRP_PHYSICAL_DEVICE_OBJECT_NAME
La funzione recupera una stringa REG_SZ che contiene 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 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 UINumber membro 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à da recuperare. 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à da recuperare. Se questo parametro è impostato su NULLe PropertyBufferSize è impostato su zero, la funzione restituisce le dimensioni necessarie per il buffer in RequiredSize.
[in] PropertyBufferSize
Dimensioni, 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
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.
Osservazioni
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 non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.
Fabbisogno
| 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 |
Vedere anche
SetupDiGetClassRegistryProperty