IWDFIoRequest：：GetWriteParameters 方法 (wudfddi.h)

警告

UMDF 2 是最新版的 UMDF，並取代 UMDF 1。 所有新的UMDF驅動程式都應該使用UMDF 2撰寫。 未將新功能新增至 UMDF 1，且較新版本的 #DAFC35F97C62C4E019ED6385A7333547E 上，UMDF 1 的支援有限。 通用 Windows 驅動程式必須使用 UMDF 2。 如需詳細資訊，請參閱使用UMDF使用者入門。

GetWriteParameters 方法會擷取寫入類型要求的要求參數。

語法

void GetWriteParameters(
  [out, optional] SIZE_T   *pSizeInBytes,
  [out, optional] LONGLONG *pullOffset,
  [out, optional] ULONG    *pulKey
);

參數

[out, optional] pSizeInBytes

接收要寫入之大小之變數的指標，以位元組為單位。 若要擷取要寫入的數據，驅動程式會呼叫 IWDFIoRequest：：GetInputMemory 方法。

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

[out, optional] pullOffset

接收位移之變數的指標，以位元組為單位，開始寫入裝置或裝置上的檔案。 如果裝置不支持絕對寫入位址，則可以忽略 pullOffset 。 如需詳細資訊，請參閱接下來的＜備註＞一節。

用戶端應用程式會在 OVERLAPPED 結構的 Offset 和 OffsetHigh 成員中指定此值。 重疊的指標會在 Microsoft Win32 WriteFile 或 WriteFileEx 函式中傳遞。

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

[out, optional] pulKey

變數的指標，可接收驅動程式可用來以驅動程序判斷的方式來排序 I/O 要求的密鑰。

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

傳回值

無

備註

如果要求類型不是寫入類型， GetWriteParameters 的呼叫就會失敗。

例如，對於支援尋址 (的裝置，磁碟裝置 ) ，pullOffset 參數指向的值通常是裝置中的位元組位移。 例如，對於不支持尋址 (的裝置，串行埠) ，驅動程式可以忽略 pullOffset 的值。

規格需求

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

另請參閱

• IWDFIoRequest
• IWDFIoRequest：：GetInputMemory