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);
    ...
}

要求

另请参阅

IQueueCallbackCreate：：OnCreateFile

IWDFIoRequest2

IWDFIoRequest：：GetCreateParameters