IWDFIoRequest：：GetReadParameters 方法 (wudfddi.h)

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 才能順利執行。

規格需求

另請參閱

• IWDFIoRequest
• IWDFIoRequest：：GetOutputMemory