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 。 可能的錯誤碼為：

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

備註

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

規格需求

需求	值
標頭	nfcradiodev.h