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 を含む) |