NfcCxHardwareEvent-Funktion (nfccx.h)

Artikel
12/21/2024

Wird vom Clienttreiber aufgerufen, wenn ein Hardwareereignis auftritt, z. B. D0Entry- und D0Exit-Rückrufe, um das Gerät zu starten oder zu beenden. Für Treiber, die firmwarebasierte Downloads für Initialisierung oder Start erfordern, empfiehlt es sich, diesen Aufruf in eine separate Arbeitsaufgabe zu verschieben. Der Clienttreiber ist jedoch für Folgendes verantwortlich:

Der Clienttreiber sollte einen Strombezug im Leerlauf ausführen, bevor die Arbeitsaufgabe in die Warteschlange gestellt wird. Der Verweis muss gelöscht werden, wenn die Arbeitsaufgabe abgeschlossen ist. Dadurch wird sichergestellt, dass die Energieverwaltung im Leerlauf nicht dazu führt, dass der Treiber in D3 wechselt, während die Arbeitsaufgabe ausgeführt wird.
Der Clienttreiber sollte die Arbeitsaufgabe mit anderen Geräterückrufen synchronisieren. Dies wird in der Regel durch die Option "AutomaticSerialization" in WDF_WORKITEM_CONFIG erreicht und das übergeordnete Element des WDFWORKITEM-Elements ist der WDFDEVICE oder durch explizites Ausführen des Arbeitselementrückrufs, d. h. WdfObjectAcquireLock auf dem WDFDEVICE.
Wenn der Hardwareereignisaufruf von einer Arbeitsaufgabe fehlschlägt, sollte der Clienttreiber den Treiber entweder neu starten oder entsperren, um zu verhindern, dass er in einem fehlerhaften Zustand ist. Dies kann mithilfe der Option "Neu starten" oder "Entladen" erreicht werden.

Syntax

NTSTATUS NfcCxHardwareEvent(
  WDFDEVICE              Device,
  PNFC_CX_HARDWARE_EVENT HardwareEvent
);

Parameter

Device

Ein Handle zu einem Framework-Geräteobjekt.

HardwareEvent

Ein Zeiger auf eine NFC_CX_HARDWARE_EVENT Struktur.

Rückgabewert

Wenn der Vorgang erfolgreich ist, gibt die Funktion STATUS_SUCCESS zurück.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Windows 10
mindestens unterstützte Server-	Keine unterstützt
Zielplattform-	Fenster
Header-	nfccx.h (include Ncidef.h)
Library	Nfccxstub.lib
DLL-	NfcCx.dll

Siehe auch

Designanleitung für NFC-Klassenerweiterungen

Designleitfaden für Near Field Communication (NFC)

Freigeben über