次の方法で共有

KsDiscardEvent 関数 (ks.h)

  • [アーティクル]

KsDiscardEvent 関数は、オブジェクトが逆参照された後、イベント エントリによって使用されるメモリを破棄します。 この関数は、イベント所有者によって無効になっていないイベントを手動で無効にするときに呼び出すことができます (イベントを無効にするには、KsFreeEventList 関数を呼び出します)。 たとえば、イベントの非同期的な有効化が失敗し、イベント エントリを破棄する必要がある場合に、関数を呼び出すことができます。

構文

KSDDKAPI VOID KsDiscardEvent(
  [in] PKSEVENT_ENTRY EventEntry
);

パラメーター

[in] EventEntry

破棄するエントリへのポインターを指定します。 このポインターは、この関数の呼び出しが成功した後で無効になります。

戻り値

何一つ

備考

通常、KsDiscardEvent 関数は、イベントを無効にする要求が発生したときに KsDisableEvent 関数によって自動的に呼び出されます。また、イベントの一覧を解放する要求が発生したときに、KsFreeEventList 関数によって自動的に呼び出されます。 この関数は、PASSIVE_LEVELでのみ呼び出すことができます。

必要条件

要件 価値
ターゲット プラットフォーム の 万国
ヘッダー ks.h (Ks.h を含む)
ライブラリ Ks.lib

関連項目

KsDisableEvent の

KsFreeEventList を する