MacChangeGroup

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