NfcCxHardwareEvent, fonction (nfccx.h)
Appelé par le pilote client lorsqu’un événement matériel se produit comme des rappels D0Entry et D0Exit 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 l’exécution 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 avoir le parent de WDFWORKITEM comme WDFDEVICE ou en ayant le rappel d’élément de travail explicitement prenant le verrou de l’appareil, c’est-à-dire WdfObjectAcquireLock sur 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 l’empêcher d’être dans un état incorrect. Cette opération peut être effectuée à l’aide de l’option Redémarrer ou Décharger.
Syntaxe
NTSTATUS NfcCxHardwareEvent(
WDFDEVICE Device,
PNFC_CX_HARDWARE_EVENT HardwareEvent
);
Paramètres
Device
Handle vers un objet d’appareil framework.
HardwareEvent
Pointeur vers une structure NFC_CX_HARDWARE_EVENT.
Valeur de retour
Si l’opération réussit, la fonction retourne STATUS_SUCCESS.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Windows 10 |
| serveur minimum pris en charge | Aucun pris en charge |
| plateforme cible | Windows |
| d’en-tête | nfccx.h (include Ncidef.h) |
| bibliothèque | Nfccxstub.lib |
| DLL | NfcCx.dll |