IOCTL_NFCSE_GET_ROUTING_TABLE IOCTL (nfcsedev.h)
返回有关侦听模式路由表的当前配置的信息。 请注意,调用方必须分配一个足够大的输出缓冲区,以保存有关当前侦听模式路由表中存在的所有条目的信息,即路由条目总数 x 路由表条目的大小,否则驱动程序应将STATUS_BUFFER_OVERFLOW错误代码返回给客户端,其中包含 NumberOfEntries 字段,其中包含配置的路由表条目数。 路由表条目的类型为 SECURE_ELEMENT_ROUTING_TABLE_ENTRY。 注意:即使 NFCC 路由表中存在条目,驱动程序也不应将输入路由 NFC-DEP 返回到 DH 作为输出缓冲区中返回的路由表的一部分。
主要代码
输入缓冲区
无
输入缓冲区长度
无
输出缓冲区
包含当前配置的所有路由条目的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”的句柄上发送,则返回此代码。 |
要求
要求 | 值 |
---|---|
Header | nfcsedev.h |