共用方式為

IOCTL_NFCSE_ENUM_ENDPOINTS IOCTL (nfcsedev.h)

  • 發行項

傳回附加至 NFC 控制器之所有安全元素清單的相關信息。 請注意，呼叫端必須配置夠大的輸出緩衝區，以保存驅動程式所列舉之所有安全元素的相關信息，也就是 SE 端點資訊的 SEs 列舉總數，否則驅動程式應該將STATUS_BUFFER_OVERFLOW錯誤碼傳回給用戶端，其中包含列舉安全元素數目的 NumberOfEndpoints 字段。 識別可能用來參考特定安全元素之安全元素的 GUID。

主要程序代碼

IRP_MJ_DEVICE_CONTROL

輸入緩衝區

無

輸入緩衝區長度

無

輸出緩衝區

列舉每個裝置 的SECURE_ELEMENT_ENDPOINT_LIST 。

狀態區塊

Irp->如果要求成功，IoStatus.Status 會設定為 STATUS_SUCCESS 。 可能的錯誤碼如下：

傳回碼 Description
STATUS_INVALID_PARAMETER 當輸出緩衝區為非零時，就會傳回此程序代碼。
STATUS_BUFFER_OVERFLOW 提供的緩衝區太小，無法接收路由表組態。

備註

以下是驅動程序必須遵守的需求。

  • 在整合式安全項目的情況下，GUID 應該是衍生自安全元素序號和/或其他安全元素唯一識別的唯一標識符。
  • 針對外部安全元素，GUID 可能是固定常數，而且只會識別安全元素所連接的「套接字」。
  • 針對裝置主機安全元素，驅動程式只有在支援主機卡模擬時，才會將其列舉為 SE 端點。 用於 DH 的 GUID 可能是驅動程式所定義的固定常數。
  • 呼叫端必須配置夠大的輸出緩衝區，以保存驅動程式所列舉之所有安全元素的相關信息。 緩衝區必須等於驅動程式列舉的 SE 總數乘以 SE 端點資訊的大小。 如果未配置適當的緩衝區，驅動程式會使用 NumberOfEndpoints 欄位傳回STATUS_BUFFER_OVERFLOW錯誤碼給用戶端，其中包含列舉的安全元素數目。

規格需求

需求 值
標頭 nfcsedev.h