Edit

Share via

KsAcquireDeviceSecurityLock function (ks.h)

  • Article

The KsAcquireDeviceSecurityLock function acquires the security lock associated with a device object. An exclusive lock is acquired when changing a security descriptor. When manipulating the security of any object under a particular device object, this lock must be acquired.

Syntax

KSDDKAPI VOID KsAcquireDeviceSecurityLock(
  [in] KSDEVICE_HEADER Header,
  [in] BOOLEAN         Exclusive
);

Parameters

[in] Header

Points to a driver-allocated device header, previously allocated by KsAllocateDeviceHeader, for the device object described by the KSDEVICE_HEADER structure.

[in] Exclusive

Indicates, if set to TRUE, that the lock is to be acquired exclusively.

Return value

None

Remarks

A shared lock is acquired when validating access during a create. An exclusive lock is acquired when changing a security descriptor.

Requirements

Requirement Value
Target Platform Universal
Header ks.h (include Ks.h)
Library Ks.lib
IRQL < DISPATCH_LEVEL

See also

KsAllocateDeviceHeader