SerCxCompleteWait 関数 (sercx.h)

SerCxCompleteWait メソッドは、シリアル フレームワーク拡張機能 (SerCx) に、現在の待機マスク内のイベントが発生したことを通知します。

構文

NTSTATUS SerCxCompleteWait(
  [in] WDFDEVICE Device,
  [in] ULONG     Event
);

パラメーター

[in] Device

シリアル コントローラーを表すフレームワーク デバイス オブジェクトへの WDFDEVICE ハンドル。

[in] Event

現在の待機操作を終了するイベントの種類。 このパラメーターは待機マスク値です。 各イベントの種類は、待機マスク内の特定のビットに対応します。 このビットは、対応するイベントが発生したことを示すように設定されます。 待機マスクで指定できるイベントの種類の詳細については、「 SERIAL_EV_XXX」を参照してください。

戻り値

SerCxCompleteWait は、呼び出しが成功した場合にSTATUS_SUCCESSを返します。 考えられるエラーの戻り値には、次の状態コードが含まれます。

注釈

SerCx がクライアントから IOCTL_SERIAL_SET_WAIT_MASK 要求を受信すると、SerCx の要求ハンドラーは EvtSerCxWaitmask コールバック関数を呼び出して、待機マスクが変更されたことをシリアル コントローラー ドライバーに通知します。 待機マスクは、シリアル コントローラーが監視するハードウェア イベントのセットを指定します。 この呼び出し中に、ドライバーは、以前 の EvtSerCxWaitmask 呼び出しで指定されている可能性がある古い待機マスクを破棄し、新しい待機マスク内のイベントを検出するようにシリアル コントローラー ハードウェアを構成します。

その後、新しい待機マスクのイベントが発生すると、ドライバーは SerCxCompleteWait を呼び出して、イベントの SerCx に通知します。 以前に送信 されたIOCTL_SERIAL_WAIT_ON_MASK 要求が保留中の場合、 SerCxCompleteWait は、STATUS_SUCCESSの状態と、発生したイベントを示す出力待機マスクを使用してこの要求を完了します。 それ以外の場合、 SerCxCompleteWait は、将来のIOCTL_SERIAL_WAIT_ON_MASK要求を見越して、イベントを内部イベント履歴 に 格納します。

要件

こちらもご覧ください

EvtSerCxWaitmask

IOCTL_SERIAL_SET_WAIT_MASK

IOCTL_SERIAL_WAIT_ON_MASK

SERIAL_EV_XXX

SerCxGetWaitMask