IOCTL_NFP_SET_PAYLOAD IOCTL (nfpdev.h)
Une application cliente envoie des données de message et confirme la publication avec la demande IOCTL_NFP_SET_PAYLOAD .
Code principal
Mémoire tampon d'entrée
La mémoire tampon d’entrée contient les données de message à transmettre.
Mémoire tampon de sortie
Aucun.
Bloc d’état
Irp-IoStatus.Status> est défini sur STATUS_SUCCESS si la demande réussit.
Sinon, état à la condition d’erreur appropriée en tant que code NTSTATUS.
Pour plus d’informations, consultez Valeurs NTSTATUS.
Remarques
Les actions suivantes sont requises lors de l’utilisation de ce IOCTL :
- Si ce IOCTL est envoyé sur un handle qui n’a pas encore été ouvert sur un « Pubs\... » filename, le pilote DOIT le compléter avec STATUS_INVALID_DEVICE_STATE.
- Les données de message sont en écriture unique. Si ce IOCTL réussit une fois, les IOCTL_NFP_SET_PAYLOAD ultérieures reçues sur le même handle DOIVENT être complétées avec STATUS_INVALID_DEVICE_STATE.
- Si l’IOCTL contient une mémoire tampon de sortie, le pilote DOIT terminer l’IOCTL avec STATUS_INVALID_PARAMETER.
- Si la mémoire tampon d’entrée est supérieure à la taille maximale des messages du pilote, le pilote DOIT terminer le IOCTL avec STATUS_INVALID_BUFFER_SIZE.
- Si un appareil devient immédiate après la réussite de cet IOCTL et avant la fermeture du handle, les données du message (ainsi que son type) NE DOIVENT être transmises qu’une seule fois à l’appareil proche.
- Si le même appareil (ou un autre) redevient proche avant la fermeture du handle, le message DOIT être transmis à nouveau.
- Si un appareil est actuellement proche lorsque ce IOCTL est terminé avec succès, les données du message (ainsi que son type) DOIVENT être transmises (une seule fois) à l’appareil proche. Cela s’applique même si le handle est immédiatement fermé.
Configuration requise
Condition requise | Valeur |
---|---|
Client minimal pris en charge | Windows 8 |
En-tête | nfpdev.h |
Voir aussi
Guide de conception globale de la communication en champ proche (NFC)
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour