IOCTL_NFCRM_SET_RADIO_STATE IOCTL (nfcradiodev.h)
この IOCTL は、近接デバイスの無線電源状態を設定するために、無線管理アプリケーションまたはサービスによって使用されます。 MediaRadioOn フィールドは、要求の電源状態を示すために使用されます。 近接無線電源状態が無効になっている場合、ドライバーは近接デバイス インターフェイス (GUID_DEVINTERFACE_NFP インターフェイスとGUID_DEVINTERFACE_SMARTCARD_READER インターフェイス) を無効にし、デバイスの P2P モードとリーダー/ライター モードを無効にする必要があります。 近接無線電源状態が有効になっている場合、ドライバーは近接デバイス インターフェイスを有効にし、コントローラーの P2P およびリーダー/ライター モードを有効にする必要があります。 このデバイスの電源モードの最適化の詳細については、「 NFC 電源管理」を参照してください。
メジャー コード
[入力バッファー]
入力バッファーの長さ
sizeof(NFCRM_SET_RADIO_STATE)
出力バッファー
なし
出力バッファーの長さ
なし
ステータス ブロック
Irp->要求が成功した場合、IoStatus.Status は STATUS_SUCCESS に設定されます。 考えられるエラー コードは次のとおりです。
リターン コード | 説明 |
---|---|
STATUS_INVALID_DEVICE_STATE | このコードは、デバイスが既にクライアントによって設定されている近接無線電源状態にある場合に返されます。 |
注釈
STATUS_INVALID_PARAMETER戻りコードは不要になりました。 ビルド 10240 Windows 10で、Windows がこの IOCTL で null 以外の出力パラメーターを送信するというバグが検出されました。 このバグは、新しいバージョンの Windows で修正されました。 コードを簡略化するために、ドライバーはすべてのバージョンのWindows 10の出力パラメーターを無視できます。
要件
要件 | 値 |
---|---|
Header | nfcradiodev.h |