Funzione SwDeviceInterfaceSetState (swdevice.h)

Articolo
03/02/2024

Abilita o disabilita un'interfaccia del dispositivo per un dispositivo software.

Sintassi

HRESULT SwDeviceInterfaceSetState(
  [in] HSWDEVICE hSwDevice,
  [in] PCWSTR    pszDeviceInterfaceId,
  [in] BOOL      fEnabled
);

Parametri

[in] hSwDevice

L'handle HSWDEVICE per il dispositivo software per registrare un'interfaccia del dispositivo.

[in] pszDeviceInterfaceId

Stringa che identifica l'interfaccia da abilitare o disabilitare.

[in] fEnabled

Valore booleano che indica se abilitare o disabilitare l'interfaccia. TRUE per abilitare; FALSE da disabilitare.

Valore restituito

S_OK viene restituito se SwDeviceInterfaceSetState è stato abilitato o disabilitato l'interfaccia; in caso contrario, un valore di errore appropriato.

Commenti

È possibile chiamare SwDeviceInterfaceSetState solo dopo che il sistema operativo ha chiamato la funzione di callback dell'app client SW_DEVICE_CREATE_CALLBACK per notificare all'app client che l'enumerazione del dispositivo è stata completata.

È possibile usare swDeviceInterfaceSetState per gestire le interfacce registrate in precedenza con SwDeviceInterfaceRegister sul dispositivo software rappresentato da hSwDevice .

Le app client usano SwDeviceInterfaceSetState per gestire lo stato in cui vogliono avere l'interfaccia. Il dispositivo software modifica lo stato effettivo dell'interfaccia in base alle esigenze. Ad esempio, un'app client disabilita e riabilita l'interfaccia se il dispositivo viene rinumerato per qualsiasi motivo. Lo stato tenta sempre di riflettere lo stato richiesto dell'app client.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 8
Server minimo supportato	Windows Server 2012
Piattaforma di destinazione	Universale
Intestazione	swdevice.h
Libreria	Swdevice.lib; OneCoreUAP.lib in Windows 10
DLL	Cfgmgr32.dll

Condividi tramite