PCPFNEVENT_HANDLER回呼函式（portcls.h）

發行項
02/07/2025

EventHandler 例程會處理事件要求。

語法

PCPFNEVENT_HANDLER PcpfneventHandler;

NTSTATUS PcpfneventHandler(
  [in] PPCEVENT_REQUEST EventRequest
)
{...}

參數

[in] EventRequest

初始化 PCEVENT_REQUEST 結構的指標

傳回值

如果呼叫成功，事件處理程式會傳回STATUS_SUCCESS。否則，它會傳回適當的錯誤碼。

言論

迷你埠驅動程序公開的每個事件都會與事件處理程式相關聯。事件處理程式的目的是處理來自埠驅動程式及其用戶端的事件要求。 EventRequest 是處理程式的輸入參數，其中包含事件的相關信息：

事件集 GUID 和事件識別碼。
事件要如何觸發。
目標迷你埠物件的指標，以及（適用於釘選）數據流物件的指標。

這類似於屬性要求所提供的資訊類型。

迷你埠驅動程式會透過其 IMiniport：：GetDescription 方法公開其事件處理程式。這個方法會輸出描述項結構（請參閱 PCFILTER_DESCRIPTOR），以定義迷你埠驅動程式及其相關聯埠驅動程式一起實作的篩選。此結構包含迷你埠驅動程式自動化數據表的指標（請參閱 PCAUTOMATION_TABLE），而此數據表又包含迷你埠驅動程式事件陣列的指標。每個數位元素都是 PCEVENT_ITEM 結構，並包含事件處理程式的PCPFNEVENT_HANDLER函式指標。

EventHandler 例程必須位於非分頁記憶體中。