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 を呼び出すことによって取得できます。
要件
| 要件 | 値 |
|---|---|
| 対象プラットフォーム | デスクトップ |
| Header | stiusd.h (Stiusd.h を含む) |