SwDeviceInterfaceSetState-Funktion (swdevice.h)

Artikel
03/02/2024

Aktiviert oder deaktiviert eine Geräteschnittstelle für ein Softwaregerät.

Syntax

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

Parameter

[in] hSwDevice

Das HSWDEVICE-Handle für das Softwaregerät, für das eine Geräteschnittstelle registriert werden soll.

[in] pszDeviceInterfaceId

Eine Zeichenfolge, die die zu aktivierende oder zu deaktivierende Schnittstelle identifiziert.

[in] fEnabled

Ein boolescher Wert, der angibt, ob die Schnittstelle aktiviert oder deaktiviert werden soll. TRUE , um zu aktivieren; Zu deaktivierende FALSE .

Rückgabewert

S_OK wird zurückgegeben, wenn SwDeviceInterfaceSetState die Schnittstelle erfolgreich aktiviert oder deaktiviert hat. andernfalls ein geeigneter Fehlerwert.

Hinweise

Sie können SwDeviceInterfaceSetState erst aufrufen, nachdem das Betriebssystem die SW_DEVICE_CREATE_CALLBACK Rückruffunktion Ihrer Client-App aufgerufen hat, um die Client-App darüber zu benachrichtigen, dass die Geräteenumeration abgeschlossen ist.

Sie können SwDeviceInterfaceSetState nur verwenden, um Schnittstellen zu verwalten, die zuvor bei SwDeviceInterfaceRegister für das Softwaregerät registriert wurden, das hSwDevice darstellt.

Client-Apps verwenden SwDeviceInterfaceSetState , um den Zustand zu verwalten, den die Schnittstelle haben soll. Das Softwaregerät ändert den tatsächlichen Schnittstellenzustand nach Bedarf. Beispielsweise deaktiviert eine Client-App die Schnittstelle und aktiviert sie erneut, wenn das Gerät aus irgendeinem Grund neu aufgezählt wird. Der Zustand versucht immer, den erforderlichen Zustand der Client-App widerzuspiegeln.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 8
Unterstützte Mindestversion (Server)	Windows Server 2012
Zielplattform	Universell
Header	swdevice.h
Bibliothek	Swdevice.lib; OneCoreUAP.lib auf Windows 10
DLL	Cfgmgr32.dll

Freigeben über