この 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 リターン コードは不要になりました。 Windows 10 ビルド 10240 で、この IOCTL で Null 以外の出力パラメーターが送信されるバグが検出されました。 このバグは、Windows の新しいバージョンで修正されました。 コードを簡略化するために、ドライバーは Windows 10 のすべてのバージョンの出力パラメーターを無視できます。
必要条件
| 要件 | 価値 |
|---|---|
| ヘッダー | nfcradiodev.h |