EVT_WDF_DEVICE_FILE_CREATE回调函数 (wdfdevice.h)

  • 项目

[适用于 KMDF 和 UMDF]

驱动程序的 EvtDeviceFileCreate 回调 函数处理应用程序请求访问设备时必须执行的操作。

语法

EVT_WDF_DEVICE_FILE_CREATE EvtWdfDeviceFileCreate;

void EvtWdfDeviceFileCreate(
  [in] WDFDEVICE Device,
  [in] WDFREQUEST Request,
  [in] WDFFILEOBJECT FileObject
)
{...}

参数

[in] Device

框架设备对象的句柄。

[in] Request

表示文件创建请求的框架请求对象的句柄。

[in] FileObject

框架文件对象的句柄，描述正在为指定请求打开的文件。 如果驱动程序为 WDF_FILEOBJECT_CONFIG 结构的 FileObjectClass 成员指定了 WdfFileObjectNotRequired，则此参数为 NULL。

返回值

无

备注

当用户应用程序或其他驱动程序打开设备以执行 I/O 操作（例如读取或写入文件）时，框架会调用驱动程序的 EvtDeviceFileCreate 回调函数。

驱动程序可以将 请求 句柄传递给 WdfRequestGetParameters ，以检索与文件创建请求关联的参数。 参数存储在 WDF_REQUEST_PARAMETERS 结构的 Parameters.Create 成员中。

此回调函数在打开设备的线程上下文中同步调用。

若要注册 EvtDeviceFileCreate 回调函数，驱动程序必须调用 WdfDeviceInitSetFileObjectConfig 方法。

驱动程序必须完成请求或使用 WDF_REQUEST_SEND_OPTION_SEND_AND_FORGET发送请求。

或者，驱动程序可以接收队列中的创建请求。 有关详细信息，请参阅 WdfDeviceConfigureRequestDispatching。

有关框架文件对象和 EvtDeviceFileCreate 回调 函数的详细信息，请参阅 框架文件对象。

要求

要求 值
目标平台 通用
最低 KMDF 版本 1.0
最低 UMDF 版本 2.0
标头 wdfdevice.h (包括 Wdf.h)
IRQL PASSIVE_LEVEL

另请参阅

WDF_FILEOBJECT_CONFIG