近距離無線通信 (NFC)

近距離無線通信 (NFC) テクノロジの概要。

近距離無線通信 (NFC) を開発するには、次のヘッダーが必要です。

• nfccx.h
• nfcradiodev.h
• nfcsedev.h
• nfpdev.h
• winsmcrd.h

プログラミング ガイドについては、「 近距離無線通信 (NFC)」を参照してください。

IOCTL

IOCTL_NFCRM_QUERY_RADIO_STATE この IOCTL は、近接デバイスの現在の無線電源状態を照会するために、無線管理アプリケーションまたはサービスによって使用されます。
IOCTL_NFCRM_SET_RADIO_STATE この IOCTL は、近接デバイスの無線電源状態を設定するために、無線管理アプリケーションまたはサービスによって使用されます。
IOCTL_NFCSE_ENUM_ENDPOINTS NFC コントローラーに接続されているすべてのセキュリティで保護された要素の一覧に関する情報を返します。
IOCTL_NFCSE_GET_NEXT_EVENT IOCTL_NFCSE_GET_NEXT_EVENTコントロール コードは、バッファーで使用可能な次のイベントを返します。または、セキュリティで保護された要素イベントが使用可能になるまで、バッファーに格納されたイベントがこれ以上存在しない場合は保留中のままです。 その後、イベントの詳細を呼び出し元に返す必要があります。
IOCTL_NFCSE_GET_NFCC_CAPABILITIES IOCTL_NFCSE_GET_NFCC_CAPABILITIES制御コードは、現在の NFC コントローラー機能に関する情報を返します。これには、最大リッスン モード ルーティング テーブル サイズ (NFC コントローラー インターフェイス (NCI) 技術仕様バージョン 1.1 のセクション 4.2 で定義) とサポートされているルーティング モードが含まれます。
IOCTL_NFCSE_GET_ROUTING_TABLE リッスン モード ルーティング テーブルの現在の構成に関する情報を返します。
IOCTL_NFCSE_HCE_REMOTE_RECV 使用可能な次のデータ バッファーを返すか、バッファーに格納されたデータがない場合、APDU バッファーが読み取り可能になるまで要求は保留中の状態を維持します。
IOCTL_NFCSE_HCE_REMOTE_SEND DeviceHost NFCEE からリモート デバイスに応答 APDU を送信します。 呼び出し元は、応答 APDU が ISO-IEC 7816-4 に準拠していることを確認する必要があります。
IOCTL_NFCSE_SET_CARD_EMULATION_MODE IOCTL_NFCSE_SET_CARD_EMULATION_MODEコントロール コードは、指定した secure 要素がエミュレーション モードで公開されるかどうかをカード設定します。
IOCTL_NFCSE_SET_ROUTING_TABLE NFC コントローラーのリッスン モード ルーティング テーブルを構成します。
IOCTL_NFCSE_SUBSCRIBE_FOR_EVENT IOCTL_NFCSE_SUBSCRIBE_FOR_EVENT制御コードは、特定のイベントをサブスクライブするためにクライアントによって発行されます。
IOCTL_NFCSERM_QUERY_RADIO_STATE IOCTL_NFCSERM_QUERY_RADIO_STATEは、SE 無線管理アプリケーションまたはサービスによって、近接デバイスの現在の無線電源状態を照会するために使用されます。
IOCTL_NFCSERM_SET_RADIO_STATE IOCTL_NFCSERM_SET_RADIO_STATEは、SE 無線管理アプリケーションまたはサービスによって、近接デバイスの現在の無線電源状態を設定するために使用されます。
IOCTL_NFP_DISABLE クライアントは、サブスクリプション、パブリケーション、プレゼンス イベントを一時的に無効にするために、IOCTL_NFP_DISABLE要求を送信します。
IOCTL_NFP_ENABLE クライアントは、以前に無効にしたサブスクリプション、パブリケーション、プレゼンス イベントを再度有効にするために、IOCTL_NFP_ENABLE要求を送信します。
IOCTL_NFP_GET_KILO_BYTES_PER_SECOND クライアントは、IOCTL_NFP_GET_KILO_BYTES_PER_SECOND要求を、公開されていない、サブスクライブされていない任意の汎用ハンドルにプロバイダー デバイスに送信します。
IOCTL_NFP_GET_MAX_MESSAGE_BYTES クライアントは、サポートされている最大メッセージ サイズを決定するために、IOCTL_NFP_GET_MAX_MESSAGE_BYTES要求を、公開されていない汎用ハンドルとサブスクライブされていない汎用ハンドルに送信します。
IOCTL_NFP_GET_NEXT_SUBSCRIBED_MESSAGE クライアントは、受信時にサブスクライブされたメッセージを受信するために、IOCTL_NFP_GET_NEXT_SUBSCRIBED_MESSAGE要求をサブスクリプション ハンドルに繰り返し送信します。
IOCTL_NFP_GET_NEXT_TRANSMITTED_MESSAGE メッセージが送信されたことを示す通知の受信に関心があるクライアントは、IOCTL_NFP_GET_NEXT_TRANSMITTED_MESSAGE要求を近接ドライバーに送信します。
IOCTL_NFP_SET_PAYLOAD クライアント アプリケーションはメッセージ データを送信し、IOCTL_NFP_SET_PAYLOAD要求でパブリケーションを確認します。
IOCTL_SMARTCARD_GET_ATTRIBUTE IOCTL_SMARTCARD_GET_ATTRIBUTEは、スマート カード属性のコード クエリを制御します。
IOCTL_SMARTCARD_GET_STATE IOCTL_SMARTCARD_GET_STATEコントロール コードは、スマート カードの現在の状態を取得します。
IOCTL_SMARTCARD_IS_ABSENT スマート カードが現在検出されていない場合、IOCTL_SMARTCARD_IS_ABSENT制御コードは STATUS_SUCCESS を使用して直ちにを返します。
IOCTL_SMARTCARD_IS_PRESENT IOCTL_SMARTCARD_IS_PRESENT制御コードは、スマート カードが現在検出されているかどうかを検出します。
IOCTL_SMARTCARD_POWER Windows では、ドライバーでこの IOCTL を NOP にして成功を返す必要がある場合があります。
IOCTL_SMARTCARD_SET_ATTRIBUTE IOCTL_SMARTCARD_SET_ATTRIBUTEコントロール コードは 属性を設定し、SCARD_ATTR_DEVICE_IN_USEでSTATUS_SUCCESSを返します。それ以外の場合は、STATUS_NOT_SUPPORTEDを返します。
IOCTL_SMARTCARD_SET_PROTOCOL カードが検出された後に、ドライバーがスマート カードと通信するプロコトルを設定します。
IOCTL_SMARTCARD_TRANSMIT クライアントから ISO7816-4 準拠 APDU で検出されたスマート カードにデータを送信します。

列挙

NFC_CX_CE_MODE_CONFIG この列挙は、CE リッスン モード フラグを指定します。
NFC_CX_DEVICE_MODE デバイス モード フラグを指定します。
NFC_CX_DRIVER_FLAGS ランタイム ドライバー フラグを指定します。
NFC_CX_HOST_ACTION NFC_CX_HOST_ACTION列挙は、ホスト アクションを指定します。
NFC_CX_NFCIP_MODE_CONFIG NFC_CX_NFCIP_MODE_CONFIG列挙は、NFC-IP イニシエーター モードを指定します。
NFC_CX_NFCIP_TGT_MODE_CONFIG NFC_CX_NFCIP_TGT_MODE_CONFIG列挙は、NFC-IP ターゲット モードを指定します。
NFC_CX_POLL_BAILOUT_CONFIG NFC_CX_POLL_BAILOUT_CONFIG列挙は、ポーリング モードのベイルアウトを指定します。
NFC_CX_POLL_MODE_CONFIG NFC_CX_POLL_MODE_CONFIG列挙はポーリング モードを指定します。
NFC_CX_SEQUENCE NFC_CX_SEQUENCE列挙はシーケンスを指定します。
NFC_CX_TRANSPORT_TYPE NFC_CX_TRANSPORT_TYPE列挙は、トランスポートの種類を指定します。
SECURE_ELEMENT_CARD_EMULATION_MODE この列挙は、セキュリティで保護された要素のカードエミュレーション モードを示します。
SECURE_ELEMENT_EVENT_TYPE セキュリティで保護された要素イベントの種類を示します。
SECURE_ELEMENT_ROUTING_TYPE SECURE_ELEMENT_ROUTING_TYPEは SECURE_ELEMENT_ROUTING_TABLE_ENTRY のメンバーです。
SECURE_ELEMENT_TYPE セキュリティで保護された要素の型を示します。

関数

EVT_NFC_CX_DEVICE_IO_CONTROL NFC CX によって呼び出され、未処理の IOCTL がクライアント ドライバーに送信されます。
EVT_NFC_CX_SEQUENCE_HANDLER NFC CX によって呼び出され、登録されている特定のシーケンスを処理するようにクライアント ドライバーに通知します。
EVT_NFC_CX_WRITE_NCI_PACKET NFC CX によって呼び出され、クライアント ドライバーに書き込みパケットが送信されます。
NFC_CX_CLIENT_CONFIG_INIT NFC_CX_CLIENT_CONFIG_INIT関数は、NFC_CX_CLIENT_CONFIG構造体を初期化します。
NFC_CX_LLCP_CONFIG_INIT NFC_CX_LLCP_CONFIG_INIT関数は、NFC_CX_LLCP_CONFIG構造体を初期化します。
NFC_CX_RF_DISCOVERY_CONFIG_INIT NFC_CX_RF_DISCOVERY_CONFIG_INIT関数は、NFC_CX_RF_DISCOVERY_CONFIG構造体を初期化します。
NfcCxDeviceDeinitialize NfcCxDeviceDeinitialize 関数 (nfccx.h) は、AddDevice ルーチン中に作成された WDF デバイスを初期化解除します。
NfcCxDeviceInitConfig DeviceInit 関数を実行するために、AddDevice ルーチン中にクライアント ドライバーによって呼び出されます。 このプロセス中に、次の I/O コールバック関数も交換されます。
NfcCxDeviceInitialize NfcCxDeviceInitialize 関数 (nfccx.h) は、AddDevice ルーチン中に作成された WDF デバイスを初期化します。
NfcCxHardwareEvent デバイスを開始または停止するために D0Entry コールバックや D0Exit コールバックなどのハードウェア イベントが発生したときに、クライアント ドライバーによって呼び出されます。 初期化または起動時にファームウェアのダウンロードを必要とするドライバーの場合は、この呼び出しを別の作業項目に移動することをお勧めします。 ただし、クライアント ドライバーは次の役割を担います。
NfcCxNciReadNotification 読み取りパケットが使用可能な場合に、クライアント ドライバーによって呼び出されます。
NfcCxRegisterSequenceHandler 初期化中にクライアント ドライバーによって呼び出され、特定のシーケンスを処理するために登録されます。
NfcCxSetLlcpConfig LLCP パラメーターを構成するためにクライアント ドライバーによって呼び出されます。
NfcCxSetRfDiscoveryConfig RF 検出パラメーターを構成するためにクライアント ドライバーによって呼び出されます。
NfcCxUnregisterSequenceHandler デバイスのシャットダウン中にクライアント ドライバーによって呼び出され、以前に登録されたシーケンス ハンドラー コールバックの登録を解除します。

構造

NFC_CX_CLIENT_CONFIG NFC_CX_CLIENT_CONFIG構造体は、NfcCxDeviceInitConfig への入力パラメーターです。
NFC_CX_HARDWARE_EVENT NFC_CX_HARDWARE_EVENT構造体は、NfcCxHardwareEvent への入力パラメーターです。
NFC_CX_LLCP_CONFIG NFC_CX_LLCP_CONFIG構造体は、NfcCxSetLlcpConfig への入力パラメーターです。
NFC_CX_RF_DISCOVERY_CONFIG NFC_CX_RF_DISCOVERY_CONFIG構造には、RF 検出構成設定が含まれています。 NfcDxDeviceInitialize を呼び出した後、初期化中に検出構成を完了する必要があります。それ以外の場合はエラーが返されます。
NFCCX_DRIVER_GLOBALS _NFCCX_DRIVER_GLOBALS構造体には、近距離無線通信 (NFC) CX ドライバーのグローバル値が含まれています。
NFCRM_RADIO_STATE この構造体は、無線の状態を示すために使用されます。
NFCRM_SET_RADIO_STATE この構造体は、無線状態を設定するために使用されます。 機内モードの場合、ドライバーは無線状態を保持し、機内モードが無効になっているときに復元する必要があります。
SCARD_IO_REQUEST この構造体は、スマート カード I/O 要求を識別するために使用されます。
SECURE_ELEMENT_AID_ROUTING_INFO SECURE_ELEMENT_AID_ROUTING_INFOは、SECURE_ELEMENT_ROUTING_TABLE_ENTRYのメンバーです。
SECURE_ELEMENT_ENDPOINT_INFO SECURE_ELEMENT_ENDPOINT_INFOは SECURE_ELEMENT_ENDPOINT_LIST のメンバーです。
SECURE_ELEMENT_ENDPOINT_LIST IOCTL_NFCSE_ENUM_ENDPOINTSの出力パラメーター。
SECURE_ELEMENT_EVENT_INFO この構造体は、セキュリティで保護された要素イベントに関する情報を提供します。
SECURE_ELEMENT_EVENT_SUBSCRIPTION_INFO SECURE_ELEMENT_EVENT_SUBSCRIPTION_INFO構造体は、IOCTL_NFCSE_SUBSCRIBE_FOR_EVENTする入力パラメーターです。
SECURE_ELEMENT_HCE_ACTIVATION_PAYLOAD _SECURE_ELEMENT_HCE_ACTIVATION_PAYLOAD構造には、一意の接続識別子と NFC フォーラム RF テクノロジとプロトコルの種類が含まれています。
SECURE_ELEMENT_HCE_DATA_PACKET SECURE_ELEMENT_HCE_DATA_PACKETは、IOCTL_NFCSE_HCE_REMOTE_RECVのIOCTL_NFCSE_HCE_REMOTE_SENDと出力バッファーへの入力バッファーです。
SECURE_ELEMENT_NFCC_CAPABILITIES SECURE_ELEMENT_NFCC_CAPABILITIESには、NFC コントローラーの機能が含まれています。
SECURE_ELEMENT_PROTO_ROUTING_INFO SECURE_ELEMENT_PROTO_ROUTING_INFOは SECURE_ELEMENT_ROUTING_TABLE_ENTRY のメンバーです。
SECURE_ELEMENT_ROUTING_TABLE SECURE_ELEMENT_ROUTING_TABLEは、IOCTL_NFCSE_SET_ROUTING_TABLEの入力パラメーターです。
SECURE_ELEMENT_ROUTING_TABLE_ENTRY SECURE_ELEMENT_ROUTING_TABLE_ENTRYは、SECURE_ELEMENT_ROUTING_TABLEのメンバーです。
SECURE_ELEMENT_SET_CARD_EMULATION_MODE_INFO SECURE_ELEMENT_SET_CARD_EMULATION_MODE_INFOは、IOCTL_NFCSE_SET_CARD_EMULATION_MODEの入力パラメーターです。
SECURE_ELEMENT_TECH_ROUTING_INFO SECURE_ELEMENT_TECH_ROUTING_INFOは SECURE_ELEMENT_ROUTING_TABLE_ENTRY のメンバーです。