Partager via

NfcCxHardwareEvent, fonction (nfccx.h)

  • Article

Appelé par le pilote client lorsqu’un événement matériel se produit, comme D0Entry et D0Exit, rappels pour démarrer ou arrêter l’appareil. Pour les pilotes qui nécessitent le téléchargement du microprogramme lors de l’initialisation ou du démarrage, il est recommandé de déplacer cet appel vers un élément de travail distinct. Toutefois, le pilote client est responsable des éléments suivants :

  • Le pilote client doit prendre une référence d’alimentation inactive avant de mettre en file d’attente l’élément de travail. La référence doit être supprimée une fois l’élément de travail terminé. Cela garantit que la gestion de l’alimentation inactive n’entraîne pas le déplacement du pilote dans D3 pendant l’exécution de l’élément de travail.
  • Le pilote client doit synchroniser l’élément de travail avec d’autres rappels d’appareil. Cela est généralement obtenu par l’option AutomaticSerialization dans WDF_WORKITEM_CONFIG et que le parent de WDFWORKITEM soit WDFDEVICE ou en faisant en sorte que le rappel d’élément de travail prenne explicitement le verrou de l’appareil, c’est-à-dire WdfObjectAcquireLock sur le WDFDEVICE.
  • Si l’appel d’événement matériel échoue à partir d’un élément de travail, le pilote client doit redémarrer ou déverrouiller le pilote pour éviter qu’il ne soit dans un état incorrect. Vous pouvez y parvenir à l’aide de l’option Redémarrer ou Décharger.

Syntaxe

NTSTATUS NfcCxHardwareEvent(
  WDFDEVICE              Device,
  PNFC_CX_HARDWARE_EVENT HardwareEvent
);

Paramètres

Device

Handle pour un objet d’appareil d’infrastructure.

HardwareEvent

Pointeur vers une structure NFC_CX_HARDWARE_EVENT .

Valeur retournée

Si l’opération réussit, la fonction retourne STATUS_SUCCESS.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 10
Serveur minimal pris en charge Aucun pris en charge
Plateforme cible Windows
En-tête nfccx.h (include Ncidef.h)
Bibliothèque Nfccxstub.lib
DLL NfcCx.dll

Voir aussi

Guide de conception de l’extension de classe NFC

Guide de conception nfc (Near Field Communication)