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

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

Никакой

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

Никакой

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

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