IStiDevice::Escape メソッド (sti.h)
IStiDevice::Escape メソッドは、ベンダー固有の I/O 操作の要求を静止画像デバイスに送信します。
構文
HRESULT Escape(
[in] STI_RAW_CONTROL_CODE EscapeFunction,
[in] LPVOID lpInData,
DWORD cbInDataSize,
[in, out] LPVOID pOutData,
DWORD dwOutDataSize,
[out] LPDWORD pdwActualData
);
パラメーター
[in] EscapeFunction
I/O 操作を表す、呼び出し元が提供するベンダー定義の DWORD サイズの値。 デバイスのミニドライバーは、この値を認識し、IStiUSD インターフェイスをエクスポートする必要があります。 ベンダー定義の値は、STI_RAW_RESERVEDより大きくする必要があります。これは、Ti.hで定義されています。
[in] lpInData
デバイスに送信されるデータを含むバッファーへの呼び出し元が指定したポインター。
cbInDataSize
lpInData が指すバッファーに含まれるデータの呼び出し元が指定した長さ (バイト単位)。
[in, out] pOutData
デバイスからデータを受信するためのメモリ バッファーへの呼び出し元指定のポインター。
dwOutDataSize
lpOutData が指すバッファーの呼び出し元が指定した長さ (バイト単位)。
[out] pdwActualData
pOutData に実際に書き込まれたバイト数を受け取ります。
戻り値
操作が成功した場合、メソッドはS_OKを返します。 それ以外の場合は、stierr.h で定義されている STIERR プレフィックス付きエラー コード返します。
備考
IStiDevice::Escape メソッドは、ベンダーが提供するミニドライバーによってエクスポート IStiUSD::Escapeを呼び出します。 デバイスのミニドライバーは、メソッド パラメーターの使用法を定義します。
IStiDevice::Escapeを呼び出す前に、IStiDevice COM インターフェイスのクライアントが IStillImage::CreateDevice を呼び出して、指定したデバイスへのアクセスを提供する IStiDevice インターフェイス ポインターを取得する必要があります。
IStiDevice::Escape の呼び出しの前に、IStiDevice::LockDevice を呼び出し、その後に IStiDevice::UnLockDevice 呼び出す必要があります。
必要条件
要件 | 価値 |
---|---|
ターゲット プラットフォーム の | デスクトップ |
ヘッダー | sti.h (Sti.h を含む) |