PCEVENT_ITEM構造体 (portcls.h)

[アーティクル]
03/05/2024

PCEVENT_ITEM構造体は、特定のフィルター、ピン、またはノードでサポートされているイベントを記述するために使用されます。

構文

typedef struct {
  const GUID         *Set;
  ULONG              Id;
  ULONG              Flags;
  PCPFNEVENT_HANDLER Handler;
} PCEVENT_ITEM, *PPCEVENT_ITEM;

メンバー

Set

イベントセットを指定します。このメンバーは、イベントセットを一意に識別する GUID へのポインターです。オーディオドライバーイベントセットのイベントセット GUID の一覧を参照してください。

Id

イベント ID を指定します。このメンバーは、イベントセット内のイベント項目を識別します。イベントセットに N 個の項目が含まれている場合、有効なイベント ID は 0 から N-1 の範囲の整数です。

Flags

イベントの種類を指定します。このメンバーは、次のいずれかの値に設定されます。

PCEVENT_ITEM_FLAG_ENABLE

このイベントの種類に対してイベント通知を有効にする必要があることを示します。ドライバーは、クライアントが明示的に無効になるまでイベント通知を続行する必要があります。

PCEVENT_ITEM_FLAG_ONESHOT

このイベントが次に発生した場合にのみ、イベント通知を有効にする必要があることを示します。クライアントは、イベントが発生した後でイベントを無効にしません (無効にする必要があります)。

PCEVENT_ITEM_FLAG_BASICSUPPORT

クライアントがこのフラグを指定した場合、ドライバーはイベントをサポートしている場合はSTATUS_SUCCESSを返し、サポートされていない場合はエラーコードを返します。

Handler

ミニポートドライバーのイベントハンドラールーチンへのポインター。このメンバーは、次のように定義PCPFNEVENT_HANDLER型の関数ポインターです。

  typedef NTSTATUS (*PCPFNEVENT_HANDLER)
  (
      IN PPCEVENT_REQUEST  EventRequest
  );

Handler ルーチンを呼び出すとき、呼び出し元は単一の呼び出しパラメーターを渡します。これは、呼び出し元によって割り当てられたPCEVENT_REQUEST構造体へのポインターです。

注釈

PCEVENT_ITEM構造体は、オートメーションテーブル内の特定のイベント項目を指定します。 PCAUTOMATION_TABLE構造体は、PCEVENT_ITEM構造体の配列を指します。

WDM オーディオでは、イベント要求のターゲットは、ピンインスタンスまたはピンのノードです。フィルターインスタンスをイベント要求のターゲットにすることはできません。

要件

要件	値
Header	portcls.h (Portcls.h を含む)

こちらもご覧ください

PCAUTOMATION_TABLE

PCEVENT_REQUEST

次の方法で共有