Freigeben über


HidSpiCxDeviceConfigure-Funktion (hidspicx.h)

Nach dem Aufrufen WdfDeviceCreateund weiterhin im EVT_WDF_DRIVER_DEVICE_ADD Rückruf ruft der Clienttreiber diese Funktion mit einem Zeiger auf eine HIDSPICX_DEVICE_CONFIG-Struktur auf, wobei die Klassenerweiterung zum Kommunizieren mit dem Gerät verwendet wird. 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 zu einem Framework-Geräteobjekt, das der Clienttreiber aus einem vorherigen Aufruf von WdfDeviceCreateabgerufen hat.

[in] DeviceConfiguration

Zeiger auf eine initialisierte HIDSPICX_DEVICE_CONFIG Struktur, wobei 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 angibt, ob die Klassenerweiterung das Gerät erfolgreich konfigurieren konnte.

Bemerkungen

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

Der Clienttreiber kann vor oder nach dem Ausführen dieses Rückrufs 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
mindestens unterstützte Client- Windows 11
Header- hidspicx.h

Siehe auch