IOCTL_NFCSE_GET_ROUTING_TABLE IOCTL (nfcsedev.h)

  • 發行項

傳回有關接聽模式路由表目前組態的資訊。 請注意，呼叫端必須配置夠大的輸出緩衝區，以保存目前接聽模式路由表中所有專案的相關信息，亦即路由表項目的總數 x 路由表專案的大小，否則驅動程式應該將STATUS_BUFFER_OVERFLOW錯誤碼傳回給用戶端，其中包含所設定路由表項目數目的 NumberOfEntries 字段。 路由表項目的類型為 SECURE_ELEMENT_ROUTING_TABLE_ENTRY。 注意：即使 NFCC 路由表中有專案，驅動程式不應該將 NFC-DEP 傳回至 DH 的專案，做為輸出緩衝區中傳回的路由表的一部分。

主要程序代碼

IRP_MJ_DEVICE_CONTROL

輸入緩衝區

無

輸入緩衝區長度

無

輸出緩衝區

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