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 インターフェイス ポインターを取得する必要があります。
要件
| 要件 | 値 |
|---|---|
| 対象プラットフォーム | デスクトップ |
| Header | sti.h (Sti.h を含む) |