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，但驅動程式必須至少指定一個非 NULL 參數，GetCreateParameters 才能順利執行。
規格需求
| 需求 | 值 |
|---|---|
| 終止支援 | UMDF 2.0 和更新版本中無法使用。 |
| 目標平台 | 桌面 |
| 最低UMDF版本 | 1.5 |
| 標頭 | wudfddi.h (包括 Wudfddi.h) |
| Dll | WUDFx.dll |