IOCTL_NFP_SET_PAYLOAD IOCTL (nfpdev.h)
Клиентское приложение отправляет данные сообщения и подтверждает публикацию с помощью запроса IOCTL_NFP_SET_PAYLOAD .
Основной код
Входной буфер
Входной буфер содержит передаваемые данные сообщений.
Выходной буфер
Нет.
Блок состояния
Irp-IoStatus.Status> имеет значение STATUS_SUCCESS, если запрос выполнен успешно.
В противном случае — Состояние до соответствующего условия ошибки в виде кода NTSTATUS.
Дополнительные сведения см. в разделе Значения NTSTATUS.
Комментарии
При использовании этого IOCTL требуются следующие действия:
- Если этот IOCTL отправляется на дескриптор, который ранее не был открыт в "Pubs\..." filename, драйвер ДОЛЖЕН дополнить его STATUS_INVALID_DEVICE_STATE.
- Данные сообщения записываются один раз. Если этот IOCTL выполняется один раз, все последующие IOCTL_NFP_SET_PAYLOAD, полученные на том же дескриптоле, должны быть завершены с STATUS_INVALID_DEVICE_STATE.
- Если IOCTL содержит выходной буфер, драйвер должен завершить IOCTL с STATUS_INVALID_PARAMETER.
- Если входной буфер больше максимального размера сообщения драйвера, драйвер должен завершить IOCTL с STATUS_INVALID_BUFFER_SIZE.
- Если какое-либо устройство становится прокси-сервером после успешного завершения IOCTL и перед закрытием дескриптора, данные сообщения (вместе с его типом) должны передаваться на прокси-устройство только один раз.
- Если одно и то же (или другое) устройство снова становится прокси-сервером перед закрытием дескриптора, сообщение должно быть передано еще раз.
- Если при успешном завершении IOCTL устройство находится на прокси-сервере, данные сообщения (вместе с его типом) должны передаваться (только один раз) на ближайшее устройство. Это применимо, даже если дескриптор немедленно закрывается.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows 8 |
| Верхняя часть | nfpdev.h |
См. также раздел
Общее руководство по проектированию связи ближнего действия (NFC)