Partager via


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

IRP_MJ_DEVICE_CONTROL

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)

Guide de conception de proximité en champ proche (Tap and Do, modèle de fournisseur NFP, exigences du pilote)