IStiUSD::SetNotificationHandle メソッド (stiusd.h)

静止画像ミニドライバーの IStiUSD::SetNotificationHandle メソッドは、ミニドライバーがデバイス イベントの呼び出し元に通知するために使用する必要があるイベント ハンドルを指定します。

構文

HRESULT SetNotificationHandle(
  HANDLE hEvent
);

パラメーター

hEvent

CreateEvent を呼び出して作成された Win32 イベントに対する呼び出し元指定のハンドル。

戻り値

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

注釈

ドライバー (およびデバイス) が 静止画像デバイス イベントの非同期通知をサポートしている場合、ミニドライバーの IStiUSD::SetNotificationHandle メソッドは、イベント モニターがイベントが発生したときに通知するようにドライバーに要求する手段です。

hEvent がイベント ハンドルの場合、IStiUSD::SetNotificationHandle メソッドはハンドルを格納し、SetEvent への入力引数として使用する必要があります (Microsoft Windows SDKドキュメントで説明)。 ドライバーは、デバイス イベントが検出されるたびに SetEvent を呼び出して、イベントが発生したことをイベント モニターに通知する必要があります。

hEvent が NULL の場合、メソッドはデバイス イベントの通知を無効にする必要があります。

要件