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

另請參閱

IWDFIoRequest

ZwCreateFile