IOCTL_NFP_SET_PAYLOAD IOCTL (nfpdev.h)

Une application cliente envoie des données de message et confirme la publication avec la demande de 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 déjà été ouvert sur un « Pubs\... » nom de fichier, le pilote DOIT l’effectuer avec STATUS_INVALID_DEVICE_STATE.
Les données de message sont en écriture seule. Si ce IOCTL réussit une seule fois, toute IOCTL_NFP_SET_PAYLOAD ultérieure reçue sur le même handle DOIT être terminée avec STATUS_INVALID_DEVICE_STATE.
Si le IOCTL contient une mémoire tampon de sortie, le pilote DOIT terminer la durée de vie du CIO avec STATUS_INVALID_PARAMETER.
Si la mémoire tampon d’entrée est supérieure à la taille maximale du message du pilote, le pilote DOIT terminer la durée de vie du CIO avec STATUS_INVALID_BUFFER_SIZE.
Si un appareil devient immédiatement proche de cette durée de vie, et avant la fermeture du handle, les données de message (ainsi que son type) doivent être transmises une seule fois à l’appareil de proximité.
Si le même appareil (ou différent) devient de nouveau proche avant la fermeture du handle, le message DOIT être transmis une fois de plus.
Si un appareil est actuellement proche de la fin de ce IOCTL, les données de message (ainsi que son type) doivent être transmises (une seule fois) à l’appareil de proximité. Cela s’applique même si le handle est immédiatement fermé.

Exigence	Valeur
client minimum pris en charge	Windows 8
d’en-tête	nfpdev.h