IStiUSD::RawReadData メソッド (stiusd.h)

静止画像ミニドライバーの IStiUSD::RawReadData メソッドは、静止画像デバイスからデータを読み取ります。

構文

HRESULT RawReadData(
  LPVOID       lpBuffer,
  LPDWORD      lpdwNumberOfBytes,
  LPOVERLAPPED lpOverlapped
);

パラメーター

lpBuffer

デバイスから読み取られたデータを受信するためのバッファーへの呼び出し元提供のポインター。

lpdwNumberOfBytes

DWORD への呼び出し元が指定したポインター。 呼び出し元は、 lpBuffer が指すバッファー内のバイト数で DWORD を読み込みます。 ドライバーは、この値を実際に読み取ったバイト数に置き換える必要があります。

lpOverlapped

省略可能で、呼び出し元が指定した OVERLAPPED 構造体へのポインター (Microsoft Windows SDKドキュメントで説明)。

戻り値

操作が成功した場合、メソッドは S_OKを返す必要があります。 それ以外の場合は、 stierr.h で定義されている STIERR プレフィックス付きエラー コードのいずれかを返す必要があります。

注釈

静止画像ミニドライバーは通常、 ReadFile を呼び出してこのメソッドを実装します (Windows SDK のドキュメントで説明)。

USB デバイスの場合、読み取り要求が最大パケット サイズ境界に合わせて調整されている場合は、パフォーマンスを向上させることができます。 最大パケット サイズは、IOCTL_GET_CHANNEL_ALIGN_RQST I/O 制御コードを指定して DeviceIoControl を呼び出すことによって取得できます。

要件

こちらもご覧ください

IStiDevice::RawReadData

IStiUSD