IWDFObject::AcquireLock メソッド (wudfddi.h)
[警告: UMDF 2 は UMDF の最新バージョンであり、UMDF 1 よりも優先されます。 すべての新しい UMDF ドライバーは、UMDF 2 を使用して記述する必要があります。 UMDF 1 には新機能が追加されておらず、新しいバージョンのWindows 10では UMDF 1 のサポートが制限されています。 ユニバーサル Windows ドライバーでは、UMDF 2 を使用する必要があります。 詳細については、「UMDF を使用したはじめに」を参照してください。
AcquireLock メソッドは、ドライバーが登録したインターフェイスのメソッドをフレームワークが呼び出さないようにします。
構文
void AcquireLock();
戻り値
なし
解説
ドライバーが AcquireLock ロック スキームを使用するようにドライバー自体を構成した場合、フレームワークはドライバーを呼び出す前に自動的に "プレゼンテーション" ロックを取得します。 (このロックスキームの詳細については、「 コールバック同期モードの指定」を参照してください)。 AcquireLock メソッドと IWDFObject::ReleaseLock メソッドは、それぞれプレゼンテーション ロックを取得および解放します。 フレームワーク デバイス オブジェクト と フレームワーク I/O キュー オブジェクト は、現在 AcquireLock メソッドをサポートしています。
ドライバーは AcquireLock メソッドを呼び出して、コールバック スコープの外部にあるコールバック インターフェイスから作成されたオブジェクトをスレッド セーフな方法で操作します。 AcquireLock メソッドは、不適切な使用によってデッドロックが発生する可能性があるため、ほとんどのドライバーが使用しないフレームワークの高度な機能を表します。
同期されていないコードは AcquireLock を呼び出すことができます。 ドライバーは、同期スコープに一致するオブジェクトに対して を呼び出す必要があります。
例
AcquireLock メソッドの使用方法のコード例については、「IWDFDevice::SetPnpState」を参照してください。
要件
| 要件 | 値 |
|---|---|
| サポート終了 | UMDF 2.0 以降では使用できません。 |
| 対象プラットフォーム | デスクトップ |
| 最小 UMDF バージョン | 1.5 |
| Header | wudfddi.h (Wudfddi.h を含む) |
| [DLL] | WUDFx.dll |