IStillImageW::SetupDeviceParameters メソッド (sti.h)

IStillImage::SetupDeviceParameters メソッドを使用すると、IStillImage COM インターフェイスのクライアントは、デバイスのバスの種類が不明な場合に、静止画像デバイスの格納されている特性を変更できます。

構文

HRESULT SetupDeviceParameters(
  [in, out] PSTI_DEVICE_INFORMATIONW unnamedParam1
);

パラメーター

[in, out] unnamedParam1

PSTI_DEVICE_INFORMATIONW パラメーター unnamedParam1 を定義します。

戻り値

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

注釈

IStillImage::SetupDeviceParameters メソッドでは、バスが識別されていない静止画像デバイスに関連付けられているデバイス パラメーターのみを変更できます。 このようなデバイスの場合、静止イメージ サーバーは、IStillImage::GetDeviceInfo が呼び出されたときに、デバイスのSTI_DEVICE_INFORMATION構造体の dwHardwareConfiguration メンバーをSTI_HW_CONFIG_UNKNOWNに設定します。

現在、変更できるデバイス パラメーターは、デバイスのポート名のみです。 このメソッドを呼び出してポート名を変更する場合は、STI_DEVICE_INFORMATIONの dwSize、 szDeviceInternalName、 および pszPortName メンバーを指定する必要があります。 他のすべてのメンバーは無視されます。

IStillImage::SetupDeviceParameters を呼び出す前に、IStillImage COM インターフェイスのクライアントは IStillImage::StiCreateInstance を呼び出して IStillImage インターフェイス ポインターを取得する必要があります。

要件