EVT_WDF_DEVICE_USAGE_NOTIFICATION callback function (wdfdevice.h)

Artikel
02/22/2024

[Applies to KMDF and UMDF]

A driver's EvtDeviceUsageNotification event callback function informs the driver when a device is being used for special files.

Syntax

EVT_WDF_DEVICE_USAGE_NOTIFICATION EvtWdfDeviceUsageNotification;

void EvtWdfDeviceUsageNotification(
  [in] WDFDEVICE Device,
  [in] WDF_SPECIAL_FILE_TYPE NotificationType,
  [in] BOOLEAN IsInNotificationPath
)
{...}

Parameters

[in] Device

A handle to a framework device object.

[in] NotificationType

A WDF_SPECIAL_FILE_TYPE-typed value that identifies the type of special file that the system is storing on the specified device.

[in] IsInNotificationPath

A Boolean value which, if TRUE, indicates that the system has starting using the special file and, if FALSE, indicate that the system as finished using the special file.

Return value

None

Remarks

To register an EvtDeviceUsageNotification callback function, a driver must call WdfDeviceInitSetPnpPowerEventCallbacks.

Your driver must provide an EvtDeviceUsageNotification callback function only if must provide driver-specific handling of special files.

For more information about special files, see Supporting Special Files.

Requirements

Requirement	Value
Target Platform	Universal
Minimum KMDF version	1.0
Minimum UMDF version	2.0
Header	wdfdevice.h (include Wdf.h)
IRQL	PASSIVE_LEVEL

Delen via