IOCTL_NFCRM_SET_RADIO_STATE IOCTL （nfcradiodev.h）

無線電管理應用程式或服務會使用此 IOCTL 來設定鄰近裝置的無線電電源狀態。 MediaRadioOn 欄位用來指出要求電源狀態。 停用鄰近無線電電源狀態時，驅動程式應該停用鄰近裝置介面（GUID_DEVINTERFACE_NFP和GUID_DEVINTERFACE_SMARTCARD_READER介面），並停用裝置的 P2P 和讀取器/寫入器模式。 如果已啟用鄰近無線電電源狀態，驅動程式應該啟用鄰近裝置介面，並啟用控制器的 P2P 和讀取器/寫入器模式。 如需優化此裝置電源模式的詳細資訊，請參閱 NFC 電源管理。

主要程序代碼

IRP_MJ_DEVICE_CONTROL

輸入緩衝區

NFCRM_SET_RADIO_STATE 結構

輸入緩衝區長度

sizeof（NFCRM_SET_RADIO_STATE）

輸出緩衝區

沒有

輸出緩衝區長度

沒有

狀態區塊

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

傳回碼	描述
STATUS_INVALID_DEVICE_STATE	當裝置已處於用戶端所設定的鄰近無線電電源狀態時，會傳回此程序代碼。

言論

不再需要 STATUS_INVALID_PARAMETER 傳回碼。 Windows 10 組建 10240 中發現 Bug，Windows 會使用此 IOCTL 傳送非 Null 輸出參數。 此 Bug 已在更新版本的 Windows 中修正。 為了簡化程式代碼，驅動程式可以忽略所有 Windows 10 版本中的輸出參數。

要求

要求	價值
標頭	nfcradiodev.h