Funzione SetupDiGetDeviceInterfacePropertyKeys (setupapi.h)
La funzione SetupDiGetDeviceInterfacePropertyKeys recupera una matrice di chiavi di proprietà del dispositivo che rappresentano le proprietà del dispositivo impostate per un'interfaccia del dispositivo.
Sintassi
WINSETUPAPI BOOL SetupDiGetDeviceInterfacePropertyKeys(
[in] HDEVINFO DeviceInfoSet,
[in] PSP_DEVICE_INTERFACE_DATA DeviceInterfaceData,
[out, optional] DEVPROPKEY *PropertyKeyArray,
[in] DWORD PropertyKeyCount,
[out, optional] PDWORD RequiredPropertyKeyCount,
[in] DWORD Flags
);
Parametri
[in] DeviceInfoSet
Handle per un set di informazioni sul dispositivo. Questo set di informazioni sul dispositivo contiene un'interfaccia del dispositivo per cui recuperare una matrice delle chiavi delle proprietà del dispositivo che rappresentano le proprietà del dispositivo impostate per un'interfaccia del dispositivo.
[in] DeviceInterfaceData
Puntatore a una struttura SP_DEVICE_INTERFACE_DATA che rappresenta l'interfaccia del dispositivo per cui recuperare la matrice richiesta di chiavi delle proprietà del dispositivo.
[out, optional] PropertyKeyArray
Puntatore a un buffer che riceve una matrice di valori tipizzati DEVPROPKEY, in cui ogni valore è una chiave di proprietà del dispositivo per una proprietà del dispositivo impostata per l'interfaccia del dispositivo. Il puntatore è facoltativo e può essere NULL. Per altre informazioni, vedere la sezione Osservazioni più avanti in questo argomento.
[in] PropertyKeyCount
Dimensioni, negli elementi tipizzato DEVPROPKEY, del buffer PropertyKeyArray. Se PropertyKeyArray è NULL, PropertyKeyCount deve essere impostato su zero.
[out, optional] RequiredPropertyKeyCount
Puntatore a una variabile tipizzata DWORD che riceve il numero di chiavi di proprietà del dispositivo richieste. Il puntatore è facoltativo e può essere impostato su NULL.
[in] Flags
Questo parametro deve essere impostato su zero.
Valore restituito
Se la funzione ha esito positivo, la funzione restituisce TRUE . In caso contrario, 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 valore di dati interno non è valido. |
|
Un parametro non è valido. Una possibilità è che l'interfaccia del dispositivo specificata da DevInterfaceData non sia valida. |
|
Un buffer utente non è valido. Una possibilità è che PropertyKeyArray è NULL e PropertKeyCount non è zero. . |
|
L'interfaccia del dispositivo specificata da DeviceInterfaceData non esiste. |
|
Il buffer PropertyKeyArray non è sufficientemente grande da contenere tutte le chiavi di proprietà richieste. |
|
Memoria di sistema insufficiente per completare l'operazione. |
Commenti
SetupDiGetDeviceInterfacePropertyKeys fa parte del modello di proprietà del dispositivo unificato.
Se il buffer PropertyKeyArray non è sufficientemente grande da contenere tutte le chiavi delle proprietà richieste, SetupDiGetDeviceInterfacePropertyKeys non recupera chiavi di proprietà e restituisce ERROR_INSUFFICIENT_BUFFER. Se il chiamante ha fornito un puntatore RequiredPropertyKeyCount, SetupDiGetDeviceInterfacePropertyKeys imposta il valore di *RequiredPropertyKeyCount sulle dimensioni necessarie, nei valori tipizzati DEVPROPKEY del buffer PropertyKeyArray.
Per recuperare una proprietà dell'interfaccia del dispositivo, chiamare SetupDiGetDeviceInterfacePropertye per impostare una proprietà dell'interfaccia del dispositivo, chiamare SetupDiSetDeviceInterfaceProperty.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Disponibile in Windows Vista e versioni successive di Windows. |
| Piattaforma di destinazione | DesktopFor universal, chiamare CM_Get_Device_Interface_Property_Keys |
| Intestazione | setupapi.h (include Setupapi.h) |
| Libreria | Setupapi.lib |
| DLL | Setupapi.dll |