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

IStillImage::EnableHwNotifications メソッドは、指定されたデバイスに対して静止画像デバイス イベントが発生したときに、アプリケーションの通知を有効または無効にするために、静止画像イベント モニターを要求します。

構文

HRESULT EnableHwNotifications(
  [in] LPCWSTR pwszDeviceName,
       BOOL    bNewState
);

パラメーター

[in] pwszDeviceName

IStillImage::GetSTILaunchInformation または IStillImage::GetDeviceList を呼び出すことによって取得される、内部デバイス名を表す文字列への呼び出し元指定のポインター。

bNewState

呼び出し元が指定した値。通知を有効にするには TRUE に、 無効にするには FALSE に設定します。

戻り値

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

注釈

IStillImage::EnableHwNotifications メソッドは、呼び出し元のアプリケーションだけでなく、すべてのアプリケーションの静止画像デバイス イベントの通知を有効または無効にします。 イベント通知は既定で有効になっています。 このメソッドは、デバイスからイベントをインターセプトして再ルーティングするアプリケーションで使用するためのものです。

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

要件

こちらもご覧ください

IStillImage::LaunchApplicationForDevice

IStillImageW