共用方式為

IWDFIoRequest：：GetReadParameters 方法 (wudfddi.h)

  • 發行項

警告

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

GetReadParameters 方法會擷取讀取類型要求的要求參數。

語法

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

參數

[out, optional] pSizeInBytes

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

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

[out, optional] pullOffset

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

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

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

[out, optional] pulKey

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

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

傳回值

無

備註

如果要求類型不是讀取類型， GetReadParameters 的呼叫就會失敗。

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

雖然驅動程式可以選擇性地為每個 pSizeInBytes、pullOffset 和 pulKey 參數指定 NULL，但驅動程式必須至少指定一個非 NULL 參數，GetReadParameters 才能順利執行。

規格需求

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

另請參閱