IOCTL_NFCSE_SET_CARD_EMULATION_MODE IOCTL (nfcsedev.h)

  • 發行項

IOCTL_NFCSE_SET_CARD_EMULATION_MODE控件程式代碼會設定指定的安全元素是否在卡片模擬模式中公開。 當安全元素「公開」做為卡片模擬時，表示當裝置帶至外部讀取器時，可讓讀取器存取安全元素。 IOCTL 會在以相對檔名 'SEManage' 開啟的檔案句柄上發出。 驅動程式必須授與客戶端的獨佔存取權來管理卡片模擬模式，也就是說，使用相對檔名 'SEManage' 開啟檔案句柄的後續呼叫將會失敗，STATUS_ACCESS_DENIED直到具有獨佔存取權的用戶端關閉其檔案句柄為止。

主要程序代碼

IRP_MJ_DEVICE_CONTROL

輸入緩衝區

SECURE_ELEMENT_SET_CARD_EMULATION_MODE_INFO 結構。

輸出緩衝區

無

狀態區塊

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

傳回碼 Description
STATUS_INVALID_PARAMETER 如果安全元素 GUID 無效，或輸出緩衝區為非零。
STATUS_INVALID_DEVICE_STATE 如果 IOCTL 是以相對名稱 『SEManage』 以外的句柄傳送。

備註

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

  • 這個 IOCTL 必須在具有 SEEvents 相對檔名的句柄上呼叫;否則，驅動程式會傳回STATUS_INVALID_DEVICE_STATE。
  • 如果卡片模擬模式已針對附加至 NFC 控制器的所有安全元素設定為模擬Off，則必須停用輪詢迴圈的模擬模式。 如果同時停用鄰近功能，驅動程式應該會轉換為低電源模式。
  • 如果卡片模擬模式設定為模擬Off 以外的值，則驅動程序必須繼續處於 D0 狀態，而且輪詢迴圈的模擬模式應該啟用 (外部讀取器) 可偵測。
  • 當 SEManage 開啟的檔案句柄關閉時，驅動程式必須將所有安全元素的卡片模擬模式設定設為模擬Off，除非最後一個設定的卡片模擬模式狀態為 EmulationOnPowerIndependent。 如果最後一個設定的卡片模擬模式狀態為EmulationOnPowerIndependent，驅動程式必須保留卡片模擬模式設定為 [開啟]，且具有特定安全元素的 PbF 選項。
  • 驅動程式必須授與客戶端的獨佔存取權，才能管理卡片模擬模式。 使用相對檔名 SEManage 開啟檔案句柄的後續呼叫會失敗，STATUS_ACCESS_DENIED直到具有獨佔存取權的用戶端關閉其檔案句柄為止。

規格需求

需求 值
標頭 nfcsedev.h