Funzione SetupDiSetDeviceInterfaceDefault (setupapi.h)

  • Articolo

La funzione SetupDiSetDeviceInterfaceDefault imposta un'interfaccia del dispositivo come interfaccia predefinita per una classe di interfaccia del dispositivo.

Sintassi

WINSETUPAPI BOOL SetupDiSetDeviceInterfaceDefault(
  [in]      HDEVINFO                  DeviceInfoSet,
  [in, out] PSP_DEVICE_INTERFACE_DATA DeviceInterfaceData,
  [in]      DWORD                     Flags,
            PVOID                     Reserved
);

Parametri

[in] DeviceInfoSet

Handle per il set di informazioni sul dispositivo che contiene l'interfaccia del dispositivo da impostare come predefinito per una classe di interfaccia del dispositivo.

[in, out] DeviceInterfaceData

Puntatore a una struttura SP_DEVICE_INTERFACE_DATA che specifica l'interfaccia del dispositivo in DeviceInfoSet.

[in] Flags

Non usato, deve essere zero.

Reserved

Riservato per uso futuro, deve essere NULL.

Valore restituito

Se la funzione ha esito positivo, la funzione restituisce TRUE . In caso contrario, restituisce FALSE e l'errore registrato può essere recuperato con una chiamata a GetLastError.

Commenti

Un chiamante deve avere privilegi di amministratore per impostare l'interfaccia predefinita per una classe di interfaccia del dispositivo. Tuttavia, se l'interfaccia predefinita richiesta corrisponde all'interfaccia predefinita attualmente impostata, la funzione restituisce TRUE indipendentemente dal fatto che il chiamante abbia privilegi di amministratore.

Se la funzione imposta correttamente l'interfaccia del dispositivo specificata come predefinita per la classe del dispositivo, aggiorna il membro Flags della struttura SP_DEVICE_INTERFACE_DATA fornita.

Chiamare SetupDiGetClassDevs per ottenere un handle DevInfoSet a un set di informazioni sul dispositivo contenente l'interfaccia del dispositivo da impostare come predefinito per una classe di interfaccia del dispositivo. Per ottenere il puntatore DeviceInterfaceData all'elemento dell'interfaccia del dispositivo, chiamare SetupDiEnumDeviceInterfaces per enumerare le interfacce nel set di informazioni sul dispositivo. Per recuperare informazioni su un'interfaccia enumerata, chiamare SetupDiGetDeviceInterfaceDetail.

Requisiti

Requisito Valore
Client minimo supportato Disponibile in Windows XP e versioni successive di Windows.
Piattaforma di destinazione Desktop
Intestazione setupapi.h (include Setupapi.h)
Libreria Setupapi.lib
DLL Setupapi.dll

Vedi anche

SetupDiEnumDeviceInterfaces

SetupDiGetClassDevs

SetupDiGetDeviceInterfaceDetail