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.

Osservazioni

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 "Pubs\..." filename, il driver DEVE completarlo con STATUS_INVALID_DEVICE_STATE.
I dati del messaggio vengono scritti una sola volta. Se l'IOCTL ha esito positivo una sola volta, tutti i IOCTL_NFP_SET_PAYLOAD successivi ricevuti sullo stesso handle DEVONO essere completati 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 un dispositivo diventa più vicino dopo l'esito positivo di questo IOCTL e prima della chiusura dell'handle, i dati del messaggio (insieme al relativo tipo) devono essere trasmessi una sola volta al dispositivo più vicino.
Se lo stesso dispositivo (o diverso) diventa nuovamente vicino 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 più vicino. Questo vale anche se l'handle viene chiuso immediatamente.

Requisito	Valore
client minimo supportato	Windows 8
intestazione	nfpdev.h