KsAcquireDeviceSecurityLock function

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


VOID KsAcquireDeviceSecurityLock(
  _In_ KSDEVICE_HEADER Header,
  _In_ BOOLEAN         Exclusive
);

Parameters

Header [in]

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

Exclusive [in]

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

Target platform

Universal

Header

Ks.h (include Ks.h)

Library

Ks.lib

IRQL

< DISPATCH_LEVEL

See also

KsAllocateDeviceHeader

 

 

Send comments about this topic to Microsoft

Show: