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

こちらもご覧ください

IWDFObject

IWDFObject::ReleaseLock