NDIS_SWITCH_REFERENCE_SWITCH_PORT 콜백 함수(ndis.h)
ReferenceSwitchPort 함수는 확장 가능한 스위치 포트에 대한 Hyper-V 확장 가능한 스위치 참조 카운터를 증가합니다.
구문
NDIS_SWITCH_REFERENCE_SWITCH_PORT NdisSwitchReferenceSwitchPort;
NDIS_STATUS NdisSwitchReferenceSwitchPort(
[in] NDIS_SWITCH_CONTEXT NdisSwitchContext,
[in] NDIS_SWITCH_PORT_ID SwitchPortId
)
{...}
매개 변수
[in] NdisSwitchContext
Hyper-V 확장 가능 스위치 확장이 연결된 확장 가능한 스위치 모듈의 핸들을 포함하는 NDIS_SWITCH_CONTEXT 값입니다. 확장이 NdisFGetOptionalSwitchHandlers를 호출하면 이 핸들은 NdisSwitchContext 매개 변수를 통해 반환됩니다.
[in] SwitchPortId
확장 가능한 스위치 참조 카운터가 증분되는 확장 가능한 스위치 포트의 고유 식별자를 포함하는 NDIS_SWITCH_PORT_ID 값입니다.
반환 값
호출이 성공하면 함수는 NDIS_STATUS_SUCCESS 반환합니다. 그렇지 않으면 Ndis.h에 정의된 NDIS_STATUS_Xxx 오류 코드를 반환합니다.
설명
확장 가능한 스위치 확장은 ReferenceSwitchPort 를 호출하여 확장 가능한 스위치 포트에 대한 참조 카운터를 증가합니다. 참조 카운터에는 0이 아닌 값이 있지만 확장 가능한 스위치의 프로토콜 에지는 확장 가능한 스위치 포트를 삭제하기 위한 OID_SWITCH_PORT_DELETE OID(개체 식별자) 집합 요청을 실행하지 않습니다.
확장에서 ReferenceSwitchPort를 호출한 후 DereferenceSwitchPort 를 호출하여 참조 카운터를 감소시켜야 합니다.
확장은 포트가 생성된 포트 상태에 도달한 후 ReferenceSwitchPort를 호출합니다. 연결이 포트 해제 또는 포트생성되지 않은 상태에 도달한 후에는 확장에서 ReferenceSwitchPort를 호출하지 않아야 합니다. 이러한 상태에 대한 자세한 내용은 Hyper-V 확장 가능한 스위치 포트 및 네트워크 어댑터 상태를 참조하세요.
확장은 포트가 활성 상태여야 하는 작업을 수행할 때 ReferenceSwitchPort 를 호출해야 합니다. 예를 들어 확장은 OID_SWITCH_PORT_PROPERTY_ENUM OID 메서드 요청을 실행하기 전에 ReferenceSwitchPort를 호출해야 합니다.
확장은 포트가 생성된 포트 상태에 도달한 후 ReferenceSwitchPort를 호출합니다. 포트가 포트 분해 상태에 도달한 후에는 확장에서 ReferenceSwitchNic를 호출하지 않아야 합니다. 이러한 상태에 대한 자세한 내용은 Hyper-V 확장 가능한 스위치 포트 및 네트워크 어댑터 상태를 참조하세요.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | NDIS 6.30 이상에서 지원됩니다. |
| 대상 플랫폼 | 데스크톱 |
| 머리글 | ndis.h(Ndis.h 포함) |
| IRQL | <= DISPATCH_LEVEL |
추가 정보
피드백
출시 예정: 2024년 내내 콘텐츠에 대한 피드백 메커니즘으로 GitHub 문제를 단계적으로 폐지하고 이를 새로운 피드백 시스템으로 바꿀 예정입니다. 자세한 내용은 다음을 참조하세요. https://aka.ms/ContentUserFeedback
다음에 대한 사용자 의견 제출 및 보기