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 を無視できます。 詳細については、「解説」を参照してください。

クライアント アプリケーションは、OVERLAPPED 構造体の Offset メンバーと OffsetHigh メンバーでこの値を指定します。 OVERLAPPED へのポインターは、Microsoft Win32 ReadFile 関数または ReadFileEx 関数で渡されます。

このパラメーターは省略可能です。 ドライバーは、情報を必要としない場合に NULL を 渡すことができます。

[out, optional] pulKey

ドライバーが決定する方法で I/O 要求を並べ替えるためにドライバーが使用できるキーを受け取る変数へのポインター。

このパラメーターは省略可能です。 ドライバーは、情報を必要としない場合に NULL を 渡すことができます。

戻り値

なし

解説

要求の種類が読み取り型でない場合、 GetReadParameters の呼び出しは失敗します。

アドレス指定をサポートするデバイス (ディスク デバイスなど) の場合、 pullOffset パラメーターが指す値は通常、デバイスへのバイト オフセットです。 アドレス指定をサポートしていないデバイス (シリアル ポートなど) の場合、ドライバーは pullOffset の値を無視できます。

ドライバーは、必要に応じて pSizeInBytes、pullOffset、および pulKey の各パラメーターに NULL を指定できますが、GetReadParameters を正常に実行するには、少なくとも 1 つの NULL 以外のパラメーターを指定する必要があります。

要件

こちらもご覧ください

• IWDFIoRequest
• IWDFIoRequest::GetOutputMemory