次の方法で共有

SerCxCompleteWait 関数 (sercx.h)

  • [アーティクル]

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

構文

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

パラメーター

[in] Device

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

[in] Event

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

戻り値

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

リターン コード 形容
STATUS_INVALID_PARAMETER
 指定されたイベントは、現在の待機マスクには含まれません。

備考

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 要求を予期して、イベントを内部イベント履歴に格納します。

必要条件

要件 価値
サポートされる最小クライアント Windows 8 以降で使用できます。
ターゲット プラットフォーム の 万国
ヘッダー sercx.h
IRQL <= DISPATCH_LEVEL

関連項目

EvtSerCxWaitmask の

IOCTL_SERIAL_SET_WAIT_MASK

IOCTL_SERIAL_WAIT_ON_MASK

SERIAL_EV_XXX

SerCxGetWaitMask の