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
指向变量的指针,该变量接收标志的位掩码,这些标志指定对与请求关联的文件请求的共享访问权限。 如果收到的位掩码为零,则请求独占访问。 有关共享访问的详细信息,请参阅 ZwCreateFile 的 ShareAccess 参数的说明。
此参数是可选的。 如果驱动程序不需要信息,驱动程序可以传递 NULL 。
返回值
无
备注
尽管驱动程序可以选择为每个 pOptions、pFileAttributes 和 pShareAccess 参数指定 NULL,但驱动程序必须为 GetCreateParameters 成功执行至少指定一个非 NULL 参数。
要求
要求 | 值 |
---|---|
结束支持 | 在 UMDF 2.0 及更高版本中不可用。 |
目标平台 | 桌面 |
最低 UMDF 版本 | 1.5 |
标头 | wudfddi.h (包括 Wudfddi.h) |
DLL | WUDFx.dll |