Funzione SetupDiGetDeviceInterfacePropertyKeys (setupapi.h)

  • Articolo

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
ERROR_INVALID_FLAGS
 Il valore di Flags non è zero.
ERROR_INVALID_HANDLE
 Il set di informazioni sul dispositivo specificato da DevInfoSet non è valido.
ERROR_INVALID_DATA
 Un valore di dati interno non è valido.
ERROR_INVALID_PARAMETER
 Un parametro non è valido. Una possibilità è che l'interfaccia del dispositivo specificata da DevInterfaceData non sia valida.
ERROR_INVALID_USER_BUFFER
 Un buffer utente non è valido. Una possibilità è che PropertyKeyArray è NULL e PropertKeyCount non è zero. .
ERROR_NO_SUCH_DEVICE_INTERFACE
 L'interfaccia del dispositivo specificata da DeviceInterfaceData non esiste.
ERROR_INSUFFICIENT_BUFFER
 Il buffer PropertyKeyArray non è sufficientemente grande da contenere tutte le chiavi di proprietà richieste.
ERROR_NOT_ENOUGH_MEMORY
 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

Vedi anche

SetupDiGetDeviceInterfaceProperty

SetupDiSetDeviceInterfaceProperty