IWDFIoRequest2：：GetCreateParametersEx 方法 (wudfddi.h)
[警告： UMDF 2 是最新版本的 UMDF，取代了 UMDF 1。 所有新的 UMDF 驱动程序都应使用 UMDF 2 编写。 未向 UMDF 1 添加新功能，并且较新版本的 Windows 10 上对 UMDF 1 的支持有限。 通用 Windows 驱动程序必须使用 UMDF 2。 有关详细信息，请参阅使用 UMDF 入门。]
GetCreateParametersEx 方法检索与正在创建或打开的文件关联的文件创建参数。
语法
void GetCreateParametersEx(
[out, optional] ULONG *pOptions,
[out, optional] USHORT *pFileAttributes,
[out, optional] USHORT *pShareAccess,
[out, optional] ACCESS_MASK *pDesiredAccess
);
参数
[out, optional] pOptions
指向调用方分配的变量的指针，该变量接收指示文件创建选项的位标志。 这些FILE_XXXX命名的位标志在 Wdm.h 中定义。
变量的低 24 位指示创建或打开文件时要应用的选项。 有关这些位的详细信息，请参阅内核模式 ZwCreateFile 函数的 CreateOptions 参数的说明。
变量的高 8 位指示在文件存在或不存在时要执行的操作。 有关这些位的详细信息，请参阅 ZwCreateFile 的 CreateDisposition 参数的说明。
此参数是可选的，可以为 NULL。
[out, optional] pFileAttributes
指向调用方分配的变量的指针，该变量接收指示文件属性的位标志。 这些FILE_ATTRIBUTE_XXXX命名的位标志在 Wdm.h 中定义。 有关这些位标志的详细信息，请参阅 ZwCreateFile 的 FileAttributes 参数的说明。
此参数是可选的，可以为 NULL。
[out, optional] pShareAccess
指向调用方分配的变量的指针，该变量接收指示文件共享选项的位标志。 这些FILE_SHARE_XXXX命名的位标志在 Wdm.h 中定义。 有关这些位标志的详细信息，请参阅 ZwCreateFile 的 ShareAccess 参数的说明。
此参数是可选的，可以为 NULL。
[out, optional] pDesiredAccess
指向调用方分配 的ACCESS_MASK 结构的指针，该结构指定对文件的请求访问权限。 有关此参数的详细信息，请参阅 ZwCreateFile 的 DesiredAccess 参数。
此参数是可选的，可以为 NULL。
返回值
无
备注
在框架调用驱动程序的 IQueueCallbackCreate：：OnCreateFile 回调函数后，驱动程序可以调用 IWDFIoRequest：：GetCreateParameters 方法或 IWDFIoRequest2：：GetCreateParametersEx 方法以获取文件的创建参数。
有关详细信息，请参阅 获取 I/O 请求的参数。
示例
下面的代码示例演示 IQueueCallbackCreate：：OnCreateFile 回调函数如何获取 IWDFIoRequest2 接口，然后调用 GetCreateParametersEx。
VOID
OnCreateFile(
__in IWDFIoQueue* FxQueue,
__in IWDFIoRequest* FxRequest,
__in IWDFFile* FxFile
)
{
ULONG fileOptions;
USHORT fileAttributes,
USHORT shareAccess,
ACCESS_MASK desiredAccess;
...
CComQIPtr<IWDFIoRequest2> fxRequest2(FxRequest);
fxRequest2->GetCreateParametersEx(&fileOptions
&fileAttributes,
&shareAccess,
&desiredAccess);
...
}
要求
| 要求 | 值 |
|---|---|
| 结束支持 | 在 UMDF 2.0 及更高版本中不可用。 |
| 目标平台 | 桌面 |
| 最低 UMDF 版本 | 1.9 |
| 标头 | wudfddi.h (包括 Wudfddi.h) |
| DLL | WUDFx.dll |