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 |