IOCTL_NFP_SET_PAYLOAD IOCTL (nfpdev.h)

Una aplicación cliente envía datos de mensajes y confirma la publicación con la solicitud de IOCTL_NFP_SET_PAYLOAD .

El búfer de entrada contiene los datos del mensaje que se van a transmitir.

Ninguno.

Irp-IoStatus.Status> se establece en STATUS_SUCCESS si la solicitud se realiza correctamente.

De lo contrario, estado de la condición de error adecuada como código NTSTATUS.

Para obtener más información, vea Valores NTSTATUS.

Comentarios

Se requieren las siguientes acciones al usar este IOCTL:

Si este IOCTL se envía en un identificador que no se ha abierto previamente en un "Pubs\..." filename, el controlador DEBE completarlo con STATUS_INVALID_DEVICE_STATE.
Los datos del mensaje se escriben una vez. Si este IOCTL se realiza correctamente una vez, cualquier IOCTL_NFP_SET_PAYLOAD posterior recibida en el mismo identificador DEBE completarse con STATUS_INVALID_DEVICE_STATE.
Si el IOCTL contiene un búfer de salida, el controlador DEBE completar el IOCTL con STATUS_INVALID_PARAMETER.
Si el búfer de entrada es mayor que el tamaño máximo del mensaje del controlador, el controlador DEBE completar el IOCTL con STATUS_INVALID_BUFFER_SIZE.
Si algún dispositivo se convierte en proxy después de que este IOCTL se realice correctamente y antes de cerrar el identificador, los datos del mensaje (junto con su tipo) deben transmitirse solo una vez al dispositivo proxy.
Si el mismo dispositivo (o diferente) vuelve a ser proxy antes de cerrar el identificador, el mensaje DEBE transmitirse una vez más.
Si un dispositivo es actualmente proxy cuando este IOCTL se completa correctamente, los datos del mensaje (junto con su tipo) deben transmitirse (solo una vez) al dispositivo proxy. Esto se aplica incluso si el identificador está cerrado inmediatamente.

Requisito	Value
Cliente mínimo compatible	Windows 8
Encabezado	nfpdev.h