次の方法で共有

NfcCxHardwareEvent 関数 (nfccx.h)

  • [アーティクル]

デバイスを開始または停止するために D0Entry コールバックや D0Exit コールバックなどのハードウェア イベントが発生したときに、クライアント ドライバーによって呼び出されます。 初期化または起動時にファームウェアのダウンロードを必要とするドライバーの場合は、この呼び出しを別の作業項目に移動することをお勧めします。 ただし、クライアント ドライバーは次の役割を担います。

  • クライアント ドライバーは、作業項目をキューに入れる前にアイドル状態の電源参照を受け取る必要があります。 作業項目が完了したら、参照を削除する必要があります。 これにより、アイドル状態の電源管理によって、作業項目の実行中にドライバーが D3 に入らないようにします。
  • クライアント ドライバーは、作業項目を他のデバイス コールバックと同期する必要があります。 これは通常、 WDF_WORKITEM_CONFIG の AutomaticSerialization オプションによって実現され、WDFWORKITEM の親を WDFDEVICE にするか、WDFDEVICE の WdfObjectAcquireLock などのデバイス ロックを明示的に取得して作業項目コールバックを設定します。
  • 作業項目からのハードウェア イベント呼び出しが失敗した場合、クライアント ドライバーはドライバーを再起動するか、ドライバーのロックを解除して、正しくない状態にならないようにする必要があります。 これは、[再起動] または [アンロード] オプションを使用して実現できます。

構文

NTSTATUS NfcCxHardwareEvent(
  WDFDEVICE              Device,
  PNFC_CX_HARDWARE_EVENT HardwareEvent
);

パラメーター

Device

フレームワーク デバイス オブジェクトへのハンドル。

HardwareEvent

NFC_CX_HARDWARE_EVENT構造体へのポインター。

戻り値

操作が成功した場合、関数は STATUS_SUCCESSを返します。

要件

要件 値
サポートされている最小のクライアント Windows 10
サポートされている最小のサーバー サポートなし
対象プラットフォーム Windows
ヘッダー nfccx.h (Ncidef.h を含む)
Library Nfccxstub.lib
[DLL] NfcCx.dll

こちらもご覧ください

NFC クラス拡張設計ガイド

近距離無線通信 (NFC) 設計ガイド