IWDFIoRequest::GetCreateParameters 方法(wudfddi.h)
[警告: UMDF 2 是最新版本的 UMDF,取代了 UMDF 1。 所有新的 UMDF 驱动程序都应使用 UMDF 2 编写。 没有将新功能添加到 UMDF 1,并且对较新版本的 Windows 10 上的 UMDF 1 的支持有限。 通用 Windows 驱动程序必须使用 UMDF 2。 有关详细信息,请参阅 UMDF入门 。]
GetCreateParameters 方法检索创建类型请求的请求参数。
语法
void GetCreateParameters(
[out, optional] ULONG *pOptions,
[out, optional] USHORT *pFileAttributes,
[out, optional] USHORT *pShareAccess
);
参数
[out, optional] pOptions
指向接收标志位掩码的变量的指针,该变量指定在创建或打开与请求关联的文件时应用的选项,以及文件已存在时要执行的作。
此参数的高 8 位对应于内核模式 ZwCreateFile 函数的 CreateDisposition 参数。 这 8 位指定要执行的作,具体取决于文件是否已存在。 请注意,这些处置值不同于 Win32 CreateFile 函数的 dwCreationDisposition 参数中使用的值。
此参数的低 24 位对应于 ZwCreateFile的 CreateOptions 参数。
此参数是可选的。 如果驱动程序不需要信息,驱动程序可以传递 NULL。
[out, optional] pFileAttributes
指向一个变量的指针,该变量接收在创建或打开与请求关联的文件时应用的属性标志的位掩码。 仅当文件创建、取代或在某些情况下覆盖文件时,才会应用显式指定的属性。 默认情况下,指定单个FILE_ATTRIBUTE_NORMAL标志。 但是,此标志可由任何其他标志或兼容标志的按位 OR 组合重写。 属性标志的位掩码对应于 ZwCreateFile的 FileAttributes 参数。
此参数是可选的。 如果驱动程序不需要信息,驱动程序可以传递 NULL。
[out, optional] pShareAccess
指向接收标志位掩码的变量的指针,该变量指定为与请求关联的文件请求的共享访问权限。 如果收到的位掩码为零,则会请求独占访问。 有关共享访问的详细信息,请参阅 ZwCreateFileShareAccess 参数的说明。
此参数是可选的。 如果驱动程序不需要信息,驱动程序可以传递 NULL。
返回值
没有
言论
尽管驱动程序可以选择为每个 pOptions、pFileAttributes和 pShareAccess 参数指定 NULL,但驱动程序必须为 GetCreateParameters 指定至少一个非NULL 参数才能成功执行。
要求
要求 | 价值 |
---|---|
终止支持 | 在 UMDF 2.0 及更高版本中不可用。 |
目标平台 | 桌面 |
最低 UMDF 版本 | 1.5 |
标头 | wudfddi.h (包括 Wudfddi.h) |
DLL | WUDFx.dll |