次の方法で共有


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 場合、メソッドはデバイス イベントの通知を無効にする必要があります。

必要条件

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