次の方法で共有

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

  • [アーティクル]

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

構文

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

パラメーター

[in, out] unnamedParam1

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

戻り値

操作が成功した場合、メソッドは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 インターフェイス ポインターを取得する必要があります。

必要条件

要件 価値
ターゲット プラットフォーム の デスクトップ
ヘッダー sti.h (Sti.h を含む)