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 |