Поделиться через


IOCTL_NFP_SET_PAYLOAD IOCTL (nfpdev.h)

Клиентское приложение отправляет данные сообщения и подтверждает публикацию с помощью запроса IOCTL_NFP_SET_PAYLOAD .

Основной код

IRP_MJ_DEVICE_CONTROL

Входной буфер

Входной буфер содержит передаваемые данные сообщений.

Выходной буфер

Нет.

Блок состояния

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)

Руководство по проектированию близкого взаимодействия с близкой областью (касания и дела, модель поставщика NFP, требования к драйверу)