共用方式為


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 結構的 OffsetOffsetHigh 成員中指定此值。 重疊的指標會在 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

另請參閱