NDIS_SWITCH_DEREFERENCE_SWITCH_NIC 콜백 함수(ndis.h)

  • 아티클

DereferenceSwitchNic 함수는 확장 가능한 스위치 포트에 연결된 네트워크 어댑터에 대한 Hyper-V 확장 가능한 스위치 참조 카운터를 감소합니다. ReferenceSwitchNic에 대한 이전 호출을 통해 참조 카운터가 증가했습니다.

구문

NDIS_SWITCH_DEREFERENCE_SWITCH_NIC NdisSwitchDereferenceSwitchNic;

NDIS_STATUS NdisSwitchDereferenceSwitchNic(
  [in] NDIS_SWITCH_CONTEXT NdisSwitchContext,
  [in] NDIS_SWITCH_PORT_ID SwitchPortId,
  [in] NDIS_SWITCH_NIC_INDEX SwitchNicIndex
)
{...}

매개 변수

[in] NdisSwitchContext

Hyper-V 확장 가능 스위치 확장이 연결된 확장 가능한 스위치 모듈의 핸들을 포함하는 NDIS_SWITCH_CONTEXT 값입니다. 확장이 NdisFGetOptionalSwitchHandlers를 호출하면 이 핸들은 NdisSwitchContext 매개 변수를 통해 반환됩니다.

[in] SwitchPortId

가상 네트워크 어댑터가 연결된 확장 가능한 스위치 포트의 고유 식별자를 포함하는 NDIS_SWITCH_PORT_ID 값입니다.

[in] SwitchNicIndex

확장 가능한 스위치 참조 카운터를 증분할 가상 네트워크 어댑터의 인덱스를 지정하는 NDIS_SWITCH_NIC_INDEX 값입니다.

NDIS_SWITCH_NIC_INDEX 값에 대한 자세한 내용은 네트워크 어댑터 인덱스 값을 참조하세요.

반환 값

호출이 성공하면 함수는 NDIS_STATUS_SUCCESS 반환합니다. 그렇지 않으면 Ndis.h에 정의된 NDIS_STATUS_Xxx 오류 코드를 반환합니다.

설명

확장 가능한 스위치 확장은 DereferenceSwitchNic 를 호출하여 확장 가능한 스위치 포트에 연결된 네트워크 어댑터에 대한 참조 카운터를 감소합니다. 확장 가능한 스위치 참조 카운터에는 0이 아닌 값이 있지만 확장 가능한 스위치의 프로토콜 에지는 어댑터에 대한 연결을 삭제하기 위해 OID_SWITCH_NIC_DELETE OID(개체 식별자) 집합 요청을 실행하지 않습니다.

이전에 네트워크 어댑터 연결에 대해 ReferenceSwitchNic를 호출한 경우 확장은 DereferenceSwitchNic를 호출해야 합니다.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 NDIS 6.30 이상에서 지원됩니다.
대상 플랫폼 데스크톱
머리글 ndis.h(Ndis.h 포함)
IRQL <= DISPATCH_LEVEL

추가 정보

NdisFGetOptionalSwitchHandlers

OID_SWITCH_NIC_DELETE

ReferenceSwitchNic