IWDFObject::AcquireLock 方法 (wudfddi.h)
[警告: UMDF 2 是最新版的 UMDF,並取代 UMDF 1。 所有新的 UMDF 驅動程式都應該使用 UMDF 2 來撰寫。 未將新功能新增至 UMDF 1,且較新版本的 Windows 10 上不支援 UMDF 1。 通用 Windows 驅動程式必須使用 UMDF 2。 如需詳細資訊,請參閱使用 UMDF 使用者入門。]
AcquireLock 方法可防止架構呼叫驅動程式註冊的介面方法。
Syntax
void AcquireLock();
傳回值
無
備註
如果驅動程式自行設定為使用 AcquireLock 鎖定配置,架構會在呼叫驅動程式之前自動取得「簡報」鎖定。 (如需此鎖定配置的詳細資訊,請參閱分別指定回呼 同步處理模式。) AcquireLock 和 IWDFObject::ReleaseLock 方法會分別取得和釋放簡報鎖定。 架構裝置物件 和 架構 I/O 佇列物件 目前支援 AcquireLock 方法。
驅動程式會呼叫 AcquireLock 方法,以安全線程的方式操作從回呼範圍外部的回呼介面所建立的物件。 AcquireLock 方法代表架構的進階功能,大部分驅動程式都不會使用,因為不當使用可能會導致死結。
未同步的程式代碼可以呼叫 AcquireLock。 驅動程式應該呼叫符合其同步處理範圍的物件。
範例
如需如何使用 AcquireLock 方法的程式代碼範例,請參閱 IWDFDevice::SetPnpState。
規格需求
需求 | 值 |
---|---|
終止支援 | UMDF 2.0 和更新版本中無法使用。 |
目標平台 | 桌面 |
最低UMDF版本 | 1.5 |
標頭 | wudfddi.h (包括 Wudfddi.h) |
Dll | WUDFx.dll |