IWDFIoRequest2：：GetCreateParametersEx 方法 (wudfddi.h)
[警告： UMDF 2 是最新版的 UMDF，並取代 UMDF 1。 所有新的 UMDF 驅動程式都應該使用 UMDF 2 來撰寫。 未將新功能新增至 UMDF 1，且較新版本的 Windows 10 上不支援 UMDF 1。 通用 Windows 驅動程式必須使用 UMDF 2。 如需詳細資訊，請參閱使用 UMDF 使用者入門。]
GetCreateParametersEx 方法會擷取與正在建立或開啟之檔案相關聯的檔案建立參數。
語法
void GetCreateParametersEx(
[out, optional] ULONG *pOptions,
[out, optional] USHORT *pFileAttributes,
[out, optional] USHORT *pShareAccess,
[out, optional] ACCESS_MASK *pDesiredAccess
);
參數
[out, optional] pOptions
呼叫端配置的變數指標，可接收指出檔案建立選項的位旗標。 這些FILE_XXXX具名的位旗標定義於 Wdm.h 中。
變數的低 24 位表示建立或開啟檔案時要套用的選項。 如需這些位的詳細資訊，請參閱核心模式 ZwCreateFile 函式的 CreateOptions 參數描述。
變數的高八位表示檔案不存在或不存在時要執行的動作。 如需這些位的詳細資訊，請參閱 ZwCreateFile 的 CreateDisposition 參數描述。
此參數是選擇性的，可以是 NULL。
[out, optional] pFileAttributes
呼叫端配置的變數指標，可接收指出檔案屬性的位旗標。 這些FILE_ATTRIBUTE_XXXX命名的位旗標定義於 Wdm.h 中。 如需這些位旗標的詳細資訊，請參閱 ZwCreateFile 的 FileAttributes 參數描述。
此參數是選擇性的，可以是 NULL。
[out, optional] pShareAccess
呼叫端配置的變數指標，可接收指出檔案共享選項的位旗標。 這些FILE_SHARE_XXXX命名的位旗標定義於 Wdm.h 中。 如需這些位旗標的詳細資訊，請參閱 ZwCreateFile 的 ShareAccess 參數描述。
此參數是選擇性的，可以是 NULL。
[out, optional] pDesiredAccess
呼叫端配置的 ACCESS_MASK 結構的指標，指定對檔案的要求存取權。 如需此參數的詳細資訊，請參閱 ZwCreateFile 的 DesiredAccess 參數。
此參數是選擇性的，可以是 NULL。
傳回值
無
備註
在架構呼叫驅動程式的 IQueueCallbackCreate：：OnCreateFile 回呼函式之後，驅動程式可以呼叫 IWDFIoRequest：：GetCreateParameters 方法或 IWDFIoRequest2：：GetCreateParametersEx 方法來取得檔案的建立參數。
如需詳細資訊，請參閱 取得 I/O 要求的參數。
範例
下列程式代碼範例示範 IQueueCallbackCreate：：OnCreateFile 回呼函式如何取得 IWDFIoRequest2 介面，然後呼叫 GetCreateParametersEx。
VOID
OnCreateFile(
__in IWDFIoQueue* FxQueue,
__in IWDFIoRequest* FxRequest,
__in IWDFFile* FxFile
)
{
ULONG fileOptions;
USHORT fileAttributes,
USHORT shareAccess,
ACCESS_MASK desiredAccess;
...
CComQIPtr<IWDFIoRequest2> fxRequest2(FxRequest);
fxRequest2->GetCreateParametersEx(&fileOptions
&fileAttributes,
&shareAccess,
&desiredAccess);
...
}
規格需求
| 需求 | 值 |
|---|---|
| 終止支援 | UMDF 2.0 和更新版本中無法使用。 |
| 目標平台 | 桌面 |
| 最低UMDF版本 | 1.9 |
| 標頭 | wudfddi.h (包括 Wudfddi.h) |
| Dll | WUDFx.dll |