次の方法で共有

StreamClassGetNextEvent 関数 (strmini.h)

  • [アーティクル]

ミニドライバーは、 StreamClassGetNextEvent ルーチンを使用して、デバイスまたは特定のストリームのイベント キューを検索できます。

構文

PKSEVENT_ENTRY StreamClassGetNextEvent(
  [in, optional] PVOID             HwInstanceExtension_OR_HwDeviceExtension,
  [in, optional] PHW_STREAM_OBJECT HwStreamObject,
  [in, optional] GUID              *EventGuid,
  [in]           ULONG             EventItem,
  [in, optional] PKSEVENT_ENTRY    CurrentEvent
);

パラメーター

[in, optional] HwInstanceExtension_OR_HwDeviceExtension

ミニドライバーのデバイス拡張機能へのポインター。 ミニドライバーは、StreamClassRegisterMinidriver を介して自身を登録するときに渡すHW_INITIALIZATION_DATA構造体内のこのバッファーのサイズを指定します。 その後、クラス ドライバーは、ミニドライバーに渡すHW_STREAM_REQUEST_BLOCK、HW_STREAM_OBJECT、HW_TIME_CONTEXT、PORT_CONFIGURATION_INFORMATION構造体の HwDeviceExtension メンバー内のバッファーにポインターを渡します。

この最初のパラメーターは PVOID HwDeviceExtension でした。 マルチインスタンスおよびマルチフィルター型 (バージョン 20) ドライバーの場合は HwInstanceExtension である必要があります。 従来の単一インスタンス ドライバーでは、最初のパラメーターとして HwDeviceExtension を引き続き指定できます。 HwInstanceExtension を指定することもできます。

[in, optional] HwStreamObject

HW_STREAM_OBJECTへのポインター。 デバイス自体のイベント キューを検索するには 、NULL に設定します。 特定のストリームのイベント キューを検索するには、 をストリームのストリーム オブジェクトに設定します。

[in, optional] EventGuid

キューのウォーク時に一致するイベント セットを指定します。または、イベント セットに一致する 場合は NULL を 指定します。

[in] EventItem

キューをウォークするときに一致するイベント ID を指定します。または、任意のイベントに一致する -1 を指定します。

[in, optional] CurrentEvent

イベント キュー内のイベントへのポインター、または NULL。

戻り値

CurrentEvent が NULL でない場合、StreamClassGetNextEvent はキュー内の CurrentEvent の後に次に一致するイベントを返します (または、このような次のイベントがない場合は NULL)。 CurrentEvent が NULL の場合、StreamClassGetNextEvent はキュー内の最初の一致するイベントを返します。

注釈

ミニドライバーは StreamClassGetNextEvent を連続して呼び出して、一度に 1 つのイベントを調べてイベント キューをループできます。

呼び出し元は、イベント キュー上のイベントに一致する追加の検索条件を指定できます。

要件

要件 値
対象プラットフォーム デスクトップ
Header strmini.h (Strmini.h を含む)
Library Stream.lib