DereferenceSwitchPort routine

The DereferenceSwitchPort function decrements the Hyper-V extensible switch reference counter for an extensible switch port. The reference counter was incremented through a previous call to ReferenceSwitchPort.

Syntax


NDIS_STATUS DereferenceSwitchPort(
  _In_ NDIS_SWITCH_CONTEXT NdisSwitchContext,
  _In_ NDIS_SWITCH_PORT_ID SwitchPortId
);

Parameters

NdisSwitchContext [in]

An NDIS_SWITCH_CONTEXT value that contains the handle of the extensible switch module to which the Hyper-V extensible switch extension is attached. When the extension calls NdisFGetOptionalSwitchHandlers, this handle is returned through the NdisSwitchContext parameter.

SwitchPortId [in]

An NDIS_SWITCH_PORT_ID value that contains the unique identifier of the extensible switch port for which the extensible switch reference counter is incremented.

Return value

If the call succeeds, the function returns NDIS_STATUS_SUCCESS. Otherwise, it returns an NDIS_STATUS_Xxx error code that is defined in Ndis.h.

Remarks

The extensible switch extension calls DereferenceSwitchPort to decrement the reference counter for an extensible switch port. While the extensible switch reference counter has a nonzero value, the protocol edge of the extensible switch will not issue an object identifier (OID) set request of OID_SWITCH_PORT_DELETE to delete the port.

The extension must call DereferenceSwitchPort if it had previously called ReferenceSwitchPort for an extensible switch port.

Requirements

Target platform

Desktop

Version

Supported in NDIS 6.30 and later.

Header

Ndis.h (include Ndis.h)

IRQL

<= DISPATCH_LEVEL

See also

NdisFGetOptionalSwitchHandlers
OID_SWITCH_PORT_DELETE
ReferenceSwitchPort

 

 

Send comments about this topic to Microsoft

Show:
© 2015 Microsoft