WnvRequestNotification 関数 (wnvapi.h)

特定の種類のイベントが発生するたびに、Windows ネットワーク仮想化 (WNV) ドライバーからの通知を要求します。

構文

ULONG WnvRequestNotification(
  HANDLE                  WnvHandle,
  PWNV_NOTIFICATION_PARAM NotificationParam,
  LPOVERLAPPED            Overlapped,
  PULONG                  BytesTransferred
);

パラメーター

WnvHandle

型: HANDLE

WnvOpen 関数の呼び出しから返されるオブジェクト ハンドル。

NotificationParam

型: PWNV_NOTIFICATION_PARAM

要求の通知の種類へのポインター。

Overlapped

型: LPOVERLAPPED

この要求の非同期完了に関する情報。 このパラメーターが NULL の場合、要求は同期です。

BytesTransferred

型: PULONG

この関数が戻るときに、 BytesTransferred パラメーターは、特定のイベントの種類の通知構造が格納されているバッファーのサイズを指します。

戻り値

型: ULONG

操作が成功した場合、関数は ERROR_SUCCESSを返します。

操作が失敗した場合、関数は次のいずれかのシステム エラー コードを返します。

リターン コード Description
ERROR_INVALID_PARAMETER
 WNV_NOTIFICATION_PARAM構造体の Header フィールドに NotificationParam パラメーターに問題があります。

注釈

この関数は、同期的または非同期的に呼び出すことができます。

WNV_NOTIFICATION_PARAM構造体には、3 種類の通知が定義されています。 この関数を呼び出すたびに、1 種類の通知のみを要求できます。 複数の通知の種類を受信するには、プロセスが同じハンドルの通知ごとに 1 つの呼び出しを行う必要があります。 WNV ドライバーは、通知イベントが発生したときに、各呼び出しで指定された種類の通知を少なくとも 1 つ返します。

Requirements

Requirement 価値
サポートされる最小クライアント サポートなし
サポートされている最小のサーバー Windows Server 2012 [デスクトップ アプリのみ]
ターゲット プラットフォーム の ウィンドウズ
Header wnvapi.h
DLL Wnvapi.dll
  • Last updated on