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 |
| サポートされる最小サーバー | サポートされていません |
| ターゲット プラットフォーム の |
ウィンドウズ |
| ヘッダー | nfccx.h (Ncidef.h を含む) |
| ライブラリ | Nfccxstub.lib |
| DLL | NfcCx.dll |