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 。 可能的錯誤碼如下:
傳回碼 | Description |
---|---|
STATUS_BUFFER_OVERFLOW | 提供的緩衝區太小,無法接收路由表組態。 |
STATUS_FEATURE_NOT_SUPPORTED | NFCC 不支援接聽模式路由設定。 |
STATUS_INVALID_PARAMETER | 如果輸入緩衝區為非零,則會傳回此程序代碼。 |
STATUS_INVALID_DEVICE_STATE | 如果 IOCTL 是以相對名稱 『SEManage』 以外的句柄傳送,就會傳回此程序代碼。 |
規格需求
需求 | 值 |
---|---|
標頭 | nfcsedev.h |