共用方式為


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 位對應至 ZwCreateFileCreateOptions 參數。

這是選擇性參數。 如果驅動程式不需要資訊,則驅動程式可以傳遞 NULL

[out, optional] pFileAttributes

變數的指標,這個變數會接收屬性旗標的位掩碼,該旗標會在建立或開啟與要求相關聯的檔案時套用。 只有在檔案建立、取代或在某些情況下覆寫時,才會套用明確指定的屬性。 根據預設,會指定單一FILE_ATTRIBUTE_NORMAL旗標。 不過,此旗標可以由任何其他旗標或相容旗標的位 OR 組合覆寫。 屬性旗標的位掩碼會對應至 ZwCreateFileFileAttributes 參數。

這是選擇性參數。 如果驅動程式不需要資訊,則驅動程式可以傳遞 NULL

[out, optional] pShareAccess

變數的指標,可接收旗標的位掩碼,指定與要求相關聯之檔案要求的共用訪問許可權。 如果收到的位掩碼為零,則會要求獨佔存取權。 如需共用存取的詳細資訊,請參閱 ZwCreateFileShareAccess 參數描述。

這是選擇性參數。 如果驅動程式不需要資訊,則驅動程式可以傳遞 NULL

傳回值

備註

雖然驅動程式可以選擇性地為每個 pOptionspFileAttributespShareAccess 參數指定 NULL,但驅動程式必須至少指定一個非 NULL 參數,GetCreateParameters 才能順利執行。

規格需求

需求
終止支援 UMDF 2.0 和更新版本中無法使用。
目標平台 桌面
最低UMDF版本 1.5
標頭 wudfddi.h (包括 Wudfddi.h)
Dll WUDFx.dll

另請參閱

IWDFIoRequest

ZwCreateFile