Edit

NDIS_FILTER_PARTIAL_CHARACTERISTICS structure (ndis.h)

  • Article

To specify optional entry points for a filter module, a filter driver initializes an NDIS_FILTER_PARTIAL_CHARACTERISTICS structure and passes it to the NdisSetOptionalHandlers function.

Syntax

typedef struct _NDIS_FILTER_PARTIAL_CHARACTERISTICS {
  NDIS_OBJECT_HEADER                            Header;
  ULONG                                         Flags;
  FILTER_SEND_NET_BUFFER_LISTS_HANDLER          SendNetBufferListsHandler;
  FILTER_SEND_NET_BUFFER_LISTS_COMPLETE_HANDLER SendNetBufferListsCompleteHandler;
  FILTER_CANCEL_SEND_HANDLER                    CancelSendNetBufferListsHandler;
  FILTER_RECEIVE_NET_BUFFER_LISTS_HANDLER       ReceiveNetBufferListsHandler;
  FILTER_RETURN_NET_BUFFER_LISTS_HANDLER        ReturnNetBufferListsHandler;
} NDIS_FILTER_PARTIAL_CHARACTERISTICS, *PNDIS_FILTER_PARTIAL_CHARACTERISTICS;

Members

Header

The NDIS_OBJECT_HEADER structure for the filter driver partial characteristics structure (NDIS_FILTER_PARTIAL_CHARACTERISTICS). Set the Type member of the structure that Header specifies to NDIS_OBJECT_TYPE_FILTER_PARTIAL_CHARACTERISTICS, the Revision member to NDIS_FILTER_PARTIAL_CHARACTERISTICS_REVISION_1, and the Size member to NDIS_SIZEOF_FILTER_PARTIAL_CHARACTERISTICS_REVISION_1.

Flags

Reserved for NDIS.

SendNetBufferListsHandler

The entry point of the caller's FilterSendNetBufferLists function. To bypass this function, set this member to NULL.

SendNetBufferListsCompleteHandler

The entry point of the caller's FilterSendNetBufferListsComplete function. To bypass this function, set this member to NULL.

CancelSendNetBufferListsHandler

The entry point of the caller's FilterCancelSendNetBufferLists function. To bypass this function, set this member to NULL.

ReceiveNetBufferListsHandler

The entry point of the caller's FilterReceiveNetBufferLists function. To bypass this function, set this member to NULL.

ReturnNetBufferListsHandler

The entry point of the caller's FilterReturnNetBufferLists function. To bypass this function, set this member to NULL.

Remarks

This structure specifies optional FilterXxx functions and other characteristics for a filter module. These characteristics override the default values that the driver set in the NDIS_FILTER_DRIVER_CHARACTERISTICS structure that the driver passed to the NdisFRegisterFilterDriver function.

Requirements

Requirement Value
Minimum supported client Supported in NDIS 6.0 and later.
Header ndis.h (include Ndis.h)

See also

FilterCancelSendNetBufferLists

FilterReceiveNetBufferLists

FilterReturnNetBufferLists

FilterSendNetBufferLists

FilterSendNetBufferListsComplete NDIS_FILTER_DRIVER_CHARACTERISTICS

NDIS_OBJECT_HEADER

NdisFRegisterFilterDriver

NdisSetOptionalHandlers