IOCTL_NFP_SET_PAYLOAD IOCTL (nfpdev.h)

Un'applicazione client invia i dati dei messaggi e conferma la pubblicazione con la richiesta di IOCTL_NFP_SET_PAYLOAD .

Il buffer di input contiene i dati del messaggio da trasmettere.

Nessuno.

Irp-IoStatus.Status> è impostato su STATUS_SUCCESS se la richiesta ha esito positivo.

In caso contrario, stato della condizione di errore appropriata come codice NTSTATUS.

Per altre informazioni, vedere Valori NTSTATUS.

Commenti

Quando si usa questo IOCTL, sono necessarie le azioni seguenti:

Se questo IOCTL viene inviato su un handle che non è stato aperto in precedenza in un "Pub\..." filename, il driver DEVE completarlo con STATUS_INVALID_DEVICE_STATE.
I dati del messaggio vengono scritti una sola volta. Se questo IOCTL ha esito positivo una volta, qualsiasi IOCTL_NFP_SET_PAYLOAD successiva ricevuta nello stesso handle deve essere completato con STATUS_INVALID_DEVICE_STATE.
Se IOCTL contiene un buffer di output, il driver DEVE completare IOCTL con STATUS_INVALID_PARAMETER.
Se il buffer di input è maggiore della dimensione massima del messaggio del driver, il driver DEVE completare IOCTL con STATUS_INVALID_BUFFER_SIZE.
Se qualsiasi dispositivo diventa proximate dopo che questo IOCTL ha esito positivo e prima che l'handle venga chiuso, i dati del messaggio (insieme al relativo tipo) devono essere trasmessi una sola volta al dispositivo proximate.
Se lo stesso dispositivo (o diverso) diventa di nuovo proximate prima che l'handle venga chiuso, il messaggio DEVE essere trasmesso nuovamente.
Se un dispositivo è attualmente vicino al completamento di questo IOCTL, i dati del messaggio (insieme al relativo tipo) devono essere trasmessi (una sola volta) al dispositivo di prossimità. Ciò si applica anche se l'handle viene chiuso immediatamente.

Requisito	Valore
Client minimo supportato	Windows 8
Intestazione	nfpdev.h