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 參數的描述。

變數的高八位表示檔案不存在或不存在時要執行的動作。 如需這些位的詳細資訊，請參閱 ZwCreateFileCreateDisposition 參數的描述。

這個參數是選擇性的，而且可以 NULL。

[out, optional] pFileAttributes

呼叫端配置的變數指標，接收指出檔案屬性的位旗標。 這些FILE_ATTRIBUTE_XXXX命名的位旗標定義於 Wdm.h 中。 如需這些位旗標的詳細資訊，請參閱 ZwCreateFile的 FileAttributes 參數描述。

這個參數是選擇性的，而且可以 NULL。

[out, optional] pShareAccess

呼叫端配置的變數指標，接收表示檔案共享選項的位旗標。 這些FILE_SHARE_XXXX命名的位旗標定義於 Wdm.h 中。 如需這些位旗標的詳細資訊，請參閱 ZwCreateFileShareAccess 參數的描述。

這個參數是選擇性的，而且可以 NULL。

[out, optional] pDesiredAccess

呼叫端配置的 ACCESS_MASK 結構的指標，指定要求的檔案存取權。 如需此參數的詳細資訊，請參閱 ZwCreateFileDesiredAccess 參數。

這個參數是選擇性的，而且可以 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

另請參閱

IQueueCallbackCreate：：OnCreateFile

IWDFIoRequest2

IWDFIoRequest：：GetCreateParameters