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 .

La mémoire tampon d’entrée contient les données de message à transmettre.

Aucun.

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é.

Condition requise	Valeur
Client minimal pris en charge	Windows 8
En-tête	nfpdev.h