IOCTL_NFCSE_GET_ROUTING_TABLE IOCTL (nfcsedev.h)
傳回接聽模式路由表目前設定的相關信息。 請注意,呼叫端必須配置足夠大的輸出緩衝區,以保存目前接聽模式路由表中所有專案的相關信息,也就是路由表專案的總數 x 路由表專案大小,否則驅動程式應該傳回STATUS_BUFFER_OVERFLOW錯誤碼給用戶端,其中包含已設定的路由表項目數目。 路由表項目的類型為 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』 以外的句柄傳送,則會傳回此程序代碼。 |
要求
要求 | 價值 |
---|---|
標頭 | nfcsedev.h |