共用方式為

PFN_WSK_CLIENT_EVENT回呼函式 (wsk.h)

  • 發行項

WskClientEvent 事件回呼函式會通知 WSK 應用程式有關非特定套接字的事件。

語法

PFN_WSK_CLIENT_EVENT PfnWskClientEvent;

NTSTATUS PfnWskClientEvent(
  [in, optional] PVOID ClientContext,
  [in]           ULONG EventType,
  [in, optional] PVOID Information,
  [in]           SIZE_T InformationLength
)
{...}

參數

[in, optional] ClientContext

傳遞至 WskRegister 函式之 WskClientNpi 參數所指定之內容值的指標。

[in] EventType

要通知 WSK 應用程式的特定事件。 目前未定義任何事件。

[in, optional] Information

緩衝區的指標，其中包含與事件相關聯的其他資訊。 如果沒有與事件相關聯的其他資訊，此指標會是 NULL。

[in] InformationLength

緩衝區中所指向之其他信息的長度
信息 參數。 如果沒有與事件相關聯的其他資訊，這個值將會是零。

傳回值

WSK 應用程式的 WskClientEvent 事件回呼函式可以傳回下列其中一個 NTSTATUS 程式代碼：

傳回碼 Description
STATUS_SUCCESS
 已成功處理事件通知。
STATUS_NOT_IMPLEMENTED
 未實作 Event 參數中傳遞的事件支援。

備註

目前， WskClientEvent 事件回呼函式未定義任何事件。 因此，如果 WSK 應用程式實作 WskClientEvent 事件回呼函式，則應該一律傳回STATUS_NOT_IMPLEMENTED。

Information 參數所指向之緩衝區中的其他資訊是唯讀的，而且只有在呼叫 WskClientEvent 事件回呼函式期間才有效。

如果 WSK 應用程式未實作 WskClientEvent 事件回呼函式，則應該先將WSK_CLIENT_DISPATCH結構的 WskClientEvent 成員設定為 NULL，再呼叫 WskRegister。

WSK 子系統會在 IRQL <= DISPATCH_LEVEL 呼叫 WSK 應用程式的 WskClientEvent 事件回呼函式。

WSK 應用程式的 WskClientEvent 事件回呼函式不得等候 WSK 完成或事件回呼函式內容中的其他 WSK 要求完成。 回呼可以起始其他 WSK 要求， (假設它不會花費太多時間在DISPATCH_LEVEL) ，但即使呼叫 IRQL = PASSIVE_LEVEL的回呼，也必須等到完成。

規格需求

需求 值
最低支援的用戶端 可在 Windows Vista 和更新版本的 Windows 作業系統中使用。
目標平台 Windows
標頭 wsk.h (包含 Wsk.h)
IRQL <= DISPATCH_LEVEL

另請參閱

WSK_CLIENT_DISPATCH

WskRegister