Edit

WNV_NOTIFICATION_PARAM structure (wnvapi.h)

  • Article

Specifies the version, notification type, and the buffer location in a WnvRequestNotification function call. The buffer specified in this structure is filled by the Windows Network Virtualization (WNV) driver when the notifications of the specific type are available.

Syntax

typedef struct _WNV_NOTIFICATION_PARAM {
  WNV_OBJECT_HEADER     Header;
  WNV_NOTIFICATION_TYPE NotificationType;
  ULONG                 PendingNotifications;
  PUCHAR                Buffer;
} WNV_NOTIFICATION_PARAM, *PWNV_NOTIFICATION_PARAM;

Members

Header

Type: WNV_OBJECT_HEADER

The version and buffer size for this structure.

NotificationType

Type: WNV_NOTIFICATION_TYPE

A value of the WNV_NOTIFICATION_TYPE enumeration that specifies the type of notifications requested, such as policy mismatches, Internet Control Message Protocol (ICMP) redirect message arrivals, and object changes.

PendingNotifications

Type: ULONG

An output value that provides the caller information about the number of pending events of the specified notification type. The pending events are queued within the WNV driver along with the events that have already been added to the Buffer field when the current WnvRequestNotification function call is completed. This field allows the WNV driver to indicate the number of remaining events to the caller of WnvRequestNotification, so the caller can estimate the size of the buffer required. The caller should post another call with enough buffer size to WnvRequestNotification to consume these remaining events.

Buffer

Type: PUCHAR

A pointer to a buffer that is filled by the WNV driver with notification structures of the specified notification type when completing the call to WnvRequestNotification. The eventual content in this field is explained by the following table.

Value of the NotificationType field Content of the Buffer field
WnvPolicyMismatchType One or more WNV_POLICY_MISMATCH_PARAM structures
WnvRedirectType One or more WNV_REDIRECT_PARAM structures
WnvObjectChangeType One or more WNV_OBJECT_CHANGE_PARAM structures

Requirements

Requirement Value
Minimum supported client None supported
Minimum supported server Windows Server 2012 [desktop apps only]
Header wnvapi.h