WdfDeviceInitSetRemoveLockOptions function

[Applies to KMDF only]

The WdfDeviceInitSetRemoveLockOptions method causes the framework to acquire a remove lock before delivering an IRP of any type to the driver.

Syntax

void WdfDeviceInitSetRemoveLockOptions(
  PWDFDEVICE_INIT          DeviceInit,
  PWDF_REMOVE_LOCK_OPTIONS Options
);

Parameters

DeviceInit

A caller-supplied pointer to a WDFDEVICE_INIT structure.

Options

A pointer to a WDF_REMOVE_LOCK_OPTIONS structure.

Return Value

This method does not return a value.

Remarks

By default, the framework acquires a remove lock before it delivers IRPs of the following major types to the driver:

IRP_MJ_PNP
IRP_MJ_POWER
IRP_MJ_SYSTEM_CONTROL

When the IRP completes, the framework releases the remove lock.

Starting in KMDF 1.11, the driver can optionally call WdfDeviceInitSetRemoveLockOptions to cause the framework to acquire a remove lock before delivering all IRP types, not just those listed above.

If your driver has kernel-mode clients that send I/O unsynchronized with the PnP state of your device, you may experience crashes due to I/O IRPs arriving after the framework device object has been removed. In this case, you can call WdfDeviceInitSetRemoveLockOptions to prevent the device object from being removed until I/O has completed.

Note  WdfDeviceInitSetRemoveLockOptions is not supported on control objects.
 
Typically, a driver calls WdfDeviceInitSetRemoveLockOptions from within its EvtDriverDeviceAdd callback function, just before calling WdfDeviceCreate.

After a driver calls WdfDeviceInitSetRemoveLockOptions, the setting remains in effect for the lifetime of the framework device object.

For more information about remove locks, see Using Remove Locks.

Examples

This code example initializes a WDF_REMOVE_LOCK_OPTIONS structure and calls WdfDeviceInitSetRemoveLockOptions.

WDF_REMOVE_LOCK_OPTIONS RemoveLockOptions;

WDF_REMOVE_LOCK_OPTIONS_INIT( &RemoveLockOptions, WDF_REMOVE_LOCK_OPTION_ACQUIRE_FOR_IO ); WdfDeviceInitSetRemoveLockOptions( DeviceInit, &RemoveLockOptions );

Requirements

   
Target Platform Universal
Minimum KMDF version 1.11
Header wdfdevice.h (include Wdf.h)
Library Wdf01000.sys (see Framework Library Versioning.)
IRQL <= DISPATCH_LEVEL
DDI compliance rules DriverCreate

See Also

WDF_REMOVE_LOCK_OPTIONS

WDF_REMOVE_LOCK_OPTIONS_FLAGS

WDF_REMOVE_LOCK_OPTIONS_INIT