Поделиться через


Метод IWDFObject::AcquireLock (wudfddi.h)

[Предупреждение: UMDF 2 является последней версией UMDF и заменяет UMDF 1. Все новые драйверы UMDF должны быть написаны с помощью UMDF 2. В UMDF 1 новые функции не добавляются, а поддержка UMDF 1 в более новых версиях Windows 10 ограничена. Универсальные драйверы Windows должны использовать UMDF 2. Дополнительные сведения см. в разделе начало работы с UMDF.]

Метод AcquireLock не позволяет платформе вызывать методы интерфейсов, зарегистрированных драйвером.

Синтаксис

void AcquireLock();

Возвращаемое значение

None

Remarks

Если драйвер настроен для использования схемы блокировки AcquireLock , платформа автоматически получает блокировку "презентация" перед вызовом драйвера. (Дополнительные сведения об этой схеме блокировки см. в разделе Указание режима синхронизации обратного вызова.) Методы AcquireLock и IWDFObject::ReleaseLock получают и освобождают блокировку презентации соответственно. Объекты устройств платформы и объекты очереди ввода-вывода платформы в настоящее время поддерживают метод AcquireLock .

Драйвер вызывает метод AcquireLock для управления объектами, созданными из интерфейсов обратного вызова за пределами область обратного вызова потокобезопасным способом. Метод AcquireLock представляет собой расширенную функцию платформы, которую не будет использовать большинство драйверов, так как неправильное использование может привести к взаимоблокировкам.

Несинхронизированный код может вызывать AcquireLock. Драйвер должен вызывать объекты, соответствующие его область синхронизации.

Примеры

Пример кода использования метода AcquireLock см. в разделе IWDFDevice::SetPnpState.

Требования

Требование Значение
Дата окончания поддержки Недоступно в UMDF 2.0 и более поздних версиях.
Целевая платформа Персональный компьютер
Минимальная версия UMDF 1.5
Верхняя часть wudfddi.h (включая Wudfddi.h)
DLL WUDFx.dll

См. также раздел

IWDFObject

IWDFObject::ReleaseLock