PCPFNEVENT_HANDLER portcls.h (回呼函式)

發行項
03/01/2024

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例程必須位於非分頁記憶體中。