HidSpiCxDeviceConfigure-Funktion (hidspicx.h)

Artikel
02/26/2024

Nachdem WdfDeviceCreate aufgerufen wurde und sich noch in seinem EVT_WDF_DRIVER_DEVICE_ADD Rückruf befindet, ruft der Clienttreiber diese Funktion mit einem Zeiger auf eine HIDSPICX_DEVICE_CONFIG-Struktur auf und gibt Schnittstellen an, die die Klassenerweiterung für die Kommunikation mit dem Gerät verwendet. Die Klassenerweiterung initialisiert ihren internen Zustand und gibt zurück, ob dies erfolgreich ist.

Syntax

NTSTATUS HidSpiCxDeviceConfigure(
  [in] WDFDEVICE               Device,
  [in] PHIDSPICX_DEVICE_CONFIG DeviceConfiguration
);

Parameter

[in] Device

Ein Handle für ein Framework-Geräteobjekt, das der Clienttreiber aus einem vorherigen Aufruf von WdfDeviceCreate abgerufen hat.

[in] DeviceConfiguration

Zeiger auf eine initialisierte HIDSPICX_DEVICE_CONFIG-Struktur , in der die Details der Rückrufe und Warteschlangen angegeben werden, die für die Kommunikation zwischen der Klassenerweiterung und dem Clienttreiber verwendet werden sollen.

Rückgabewert

NTSTATUS , der angibt, ob die Klassenerweiterung das Gerät erfolgreich konfigurieren konnte.

Hinweise

Die Klassenerweiterung initialisiert den internen Zustand und gibt zurück, ob dies erfolgreich ist.

Der Clienttreiber kann vor oder nach diesem Rückruf eine Standardwarteschlange erstellen, um IOCTLs zu behandeln, die nicht von der Klassenerweiterung behandelt werden.

Clienttreiber sollten nicht versuchen, den Besitz von Energierichtlinien zu erwerben, um Energierichtlinieneinstellungen zu konfigurieren. HidClass und HidSpiCx sind für die Verwaltung der Energierichtlinie des Geräts verantwortlich.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 11
Kopfzeile	hidspicx.h

Freigeben über