共用方式為


PCEVENT_ITEM結構 (portcls.h)

PCEVENT_ITEM 結構可用來描述特定篩選、釘選或節點所支援的事件。

語法

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

成員

Set

指定事件集。 這個成員是可唯一識別事件集之 GUID 的指標。 請參閱 Audio Drivers 事件集中的事件集 GUID 清單。

Id

指定事件識別碼。 這個成員會識別事件集內的事件專案。 如果事件集包含 N 個專案,有效的事件標識碼是範圍 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音訊中,事件要求的目標為針腳實例或針腳上的節點。 篩選實例不能是事件要求的目標。

要求

要求 價值
標頭 portcls.h (包括 Portcls.h)

另請參閱

PCAUTOMATION_TABLE

PCEVENT_REQUEST