NDIS_STATUS
MacChangeGroup(
IN TR_GROUP_ADDRESS OldGroupAddress,
IN TR_GROUP_ADDRESS NewGroupAddress,
IN NDIS_HANDLE MacBindingHandle,
IN PNDIS_REQUEST NdisRequest,
IN BOOLEAN Set
);
MacChangeGroup is a NIC driver action function the Token Ring filter library calls to initiate processing when the group address for all bindings has changed.
Parameters
OldGroupAddress
Specifies the original group address.
NewGroupAddress
Specifies the new group address.
MacBindingHandle
Specifies the handle that the NIC driver associates with the binding that causes the change.
NdisRequest
Points to a request structure.
Set
Specifies TRUE if changes are being caused by a set request rather than the closing of the binding.
Return Value
MacChangeGroup can return the following status codes:
NDIS_STATUS_PENDING
NDIS_STATUS_RESET_IN_PROGRESS
NDIS_STATUS_SUCCESS
Comments
The NIC driver supplied the entry point for MacChangeGroup when it called TrCreateFilter to set up the Token Ring filter database.
TrChangeGroupAddress, which the NIC driver calls after it acquires the filter database spin lock, actually calls MacChangeGroup only after checking the current group address list for all bound protocols and determining that it requires changes.
If MacChangeGroup returns anything other than NDIS_STATUS_SUCCESS or NDIS_STATUS_PENDING, TrChangeGroupAddress discards any changes this function made to the group address.
MacChangeGroup runs at IRQL DISPATCH_LEVEL.
See Also
MacAddAdapter, NdisAcquireSpinLock, TrChangeGroupAddress, TrCreateFilter