IOCTL_NFP_DISABLE IOCTL (nfpdev.h)

  • [アーティクル]

クライアントは 、サブスクリプション 、パブリケーション、プレゼンス イベントを一時的に無効にするために、IOCTL_NFP_DISABLE要求を送信します。 これは、クライアントが近接機能を無効にし、リソースを割り当てたままにして、再び必要になったときにすばやく再び有効にしたい場合に便利です。

メジャー コード

IRP_MJ_DEVICE_CONTROL

[入力バッファー]

なし

出力バッファー

なし

ステータス ブロック

要求が成功した場合、Irp-IoStatus.Status> はSTATUS_SUCCESSに設定されます。

それ以外の場合は、NTSTATUS コードとして適切なエラー条件の状態。

詳細については、「 NTSTATUS 値」を参照してください。

注釈

この IOCTL を使用する場合に必要なアクションを次に示します。

  • この IOCTL が受信されると、ドライバーはファイル ハンドルを "無効" としてマークする必要があります。
  • サブスクリプション ハンドルが "無効" に変更された場合、プロバイダーはそのファイル ハンドルの "Received" キューからすべてのメッセージを削除する必要があります。
  • サブスクリプション ハンドルが "無効" の場合:
    • ドライバーは、キュー内の既存のメッセージを消去 (削除) し、受信した直後にキューから新しいメッセージを削除することで、そのハンドルの "受信済み" キューの長さをゼロのままにする必要があります。
    • ドライバーは、STATUS_CANCELLEDを 使用して、 そのハンドルに対するすべての pended IOCTL_NFP_GET_NEXT_SUBSCRIBED_MESSAGE要求を完了する必要があります。
  • パブリケーション ハンドルが "無効" の場合、プロバイダーはパブリケーションのメッセージを送信せず、そのハンドルに対するすべての ペンドされたIOCTL_NFP_GET_NEXT_TRANSMITTED_MESSAGE 要求を完了する必要STATUS_CANCELLED

要件

要件 値
サポートされている最小のクライアント Windows 8
Header nfpdev.h

こちらもご覧ください

IOCTL_NFP_ENABLE

近距離無線通信 (NFC) の全体的な設計ガイド

近距離距離設計ガイド (Tap and Do、NFP プロバイダー モデル、ドライバー要件)