IOCTL_NFCSE_GET_ROUTING_TABLE IOCTL (nfcsedev.h)

Возвращает сведения о текущей конфигурации таблицы маршрутизации режима прослушивания. Обратите внимание, что вызывающий объект должен выделить буфер вывода, достаточно большой для хранения сведений обо всех записях, которые присутствуют в текущей таблице маршрутизации режима прослушивания, т. е. общее количество записей маршрутизации x Запись таблицы маршрутизации Размер таблицы маршрутизации, в противном случае драйвер должен вернуть клиенту код ошибки STATUS_BUFFER_OVERFLOW с полем NumberOfEntries, содержащим число настроенных записей таблицы маршрутизации. Запись таблицы маршрутизации имеет тип SECURE_ELEMENT_ROUTING_TABLE_ENTRY. Примечание. Драйвер не должен возвращать входную маршрутизацию NFC-DEP в DH как часть таблицы маршрутизации, возвращенной в выходном буфере, даже если запись присутствует в таблице маршрутизации NFCC.

Основной код

IRP_MJ_DEVICE_CONTROL

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

None

Длина входного буфера

None

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

SECURE_ELEMENT_ROUTING_TABLE , содержащий все настроенные в настоящее время записи маршрутизации.

Длина выходного буфера

sizeof(SECURE_ELEMENT_ROUTING_TABLE)

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

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

Код возврата Описание
STATUS_BUFFER_OVERFLOW Предоставленный буфер был слишком мал для получения конфигурации таблицы маршрутизации.
STATUS_FEATURE_NOT_SUPPORTED NFCC не поддерживает конфигурацию маршрутизации в режиме прослушивания.
STATUS_INVALID_PARAMETER Этот код возвращается, если входной буфер не равен нулю.
STATUS_INVALID_DEVICE_STATE Этот код возвращается, если IOCTL отправляется на дескриптор, отличный от относительного имени "SEManage".

Требования

Требование Значение
Заголовок nfcsedev.h