NdisFSetAttributes function

A filter driver calls the NdisFSetAttributes function to specify a filter module context area.

Syntax


NDIS_STATUS NdisFSetAttributes(
  _In_  NDIS_HANDLE NdisFilterHandle,
  _In_  NDIS_HANDLE FilterModuleContext,
  _In_  PNDIS_FILTER_ATTRIBUTES FilterAttributes
);

Parameters

NdisFilterHandle [in]

The NDIS handle that identifies this filter module. NDIS passed the handle to the filter driver in a call to the FilterAttach function.

FilterModuleContext [in]

The caller-allocated context area for this filter module.

FilterAttributes [in]

A pointer to a filter driver allocated NDIS_FILTER_ATTRIBUTES structure.

Return value

NdisFSetAttributes returns one of the following status values:

Return codeDescription
NDIS_STATUS_SUCCESS

NdisFSetAttributes returns NDIS_STATUS_SUCCESS if it set the filter driver attributes.

NDIS_STATUS_RESOURCES

NdisFSetAttributes failed because of insufficient resources.

NDIS_STATUS_FAILURE

NdisFSetAttributes returns NDIS_STATUS_FAILURE if none of the preceding values applies.

 

Remarks

A filter driver calls NdisFSetAttributes from its FilterAttach function and passes the handle that NDIS passed to FilterAttach at the NdisFilterHandle parameter. The FilterModuleContext parameter of NdisFSetAttributes specifies the context area for this filter module. NDIS passes the context area back to the filter driver in calls to functions such as FilterSendNetBufferLists.

Requirements

Version

Supported in NDIS 6.0 and later.

Header

Ndis.h (include Ndis.h)

IRQL

PASSIVE_LEVEL

DDI compliance rules

Irql_Filter_Driver_Function

See also

FilterAttach
FilterSendNetBufferLists
NDIS_FILTER_ATTRIBUTES

 

 

Send comments about this topic to Microsoft

Show:
© 2014 Microsoft