IOCTL_NFP_GET_MAX_MESSAGE_BYTES IOCTL (nfpdev.h)

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

Основной код

IRP_MJ_DEVICE_CONTROL

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

None

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

Одно значение INT32 , определяющее максимальный размер сообщения, поддерживаемый предоставлением.

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

Irp-IoStatus.Status> имеет значение STATUS_SUCCESS, если запрос выполнен успешно.

В противном случае — состояние соответствующего условия ошибки в виде кода NTSTATUS.

Дополнительные сведения см. в разделе Значения NTSTATUS.

Комментарии

  • Каждая реализация поставщика может указать максимальный размер сообщения для публикаций и подписок. Windows требует, чтобы этот максимальный размер сообщения, поддерживаемый поставщиком, был не менее 10 КБ.
  • При использовании этого ioctl необходимо выполнить следующие действия:
    • Драйвер должен поддерживать максимальный размер сообщения не менее 10 КБ.
    • При получении этого IOCTL драйвер ДОЛЖЕН скопировать максимальный размер сообщения в выходной буфер и завершить его с помощью STATUS_SUCCESS.

Требования

Требование Значение
Минимальная версия клиента Windows 8
Верхняя часть nfpdev.h

См. также раздел

Общее руководство по проектированию ближней связи (NFC)

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