OID_SWITCH_NIC_CONNECT
Hyper-V 확장 가능 스위치의 프로토콜 에지는 확장 가능한 스위치 포트와 네트워크 어댑터 간의 네트워크 연결이 완전히 설정되었음을 기본 확장 가능한 스위치 확장에 알리기 위해 OID_SWITCH_NIC_CONNECT 개체 식별자(OID) 집합 요청을 실행합니다. 프로토콜 에지는 이전에 OID_SWITCH_NIC_CREATE OID 집합 요청을 실행했을 때 이 연결이 설정되고 있음을 확장에 알렸습니다.
NDIS_OID_REQUEST 구조체의 InformationBuffer 멤버는 NDIS_SWITCH_NIC_PARAMETERS 구조체에 대한 포인터를 포함합니다.
설명
NDIS_SWITCH_NIC_PARAMETERS 구조체의 PortId 멤버는 연결 알림이 만들어지는 확장 가능한 스위치 포트를 지정합니다. 확장 가능한 스위치 확장은 다음과 같은 방법으로 이 포트 및 기타 확장 가능한 스위치 포트에 대한 매개 변수 정보를 가져올 수 있습니다.
OID_SWITCH_PORT_ARRAY OID 쿼리 요청을 실행합니다. 확장은 IsActive가 TRUE로 설정된 OID_SWITCH_PARAMETERS NDIS_SWITCH_PARAMETERS 구조를 반환하는 경우에만 FilterAttach에서 이 OID를 실행합니다. IsActive가 FALSE이면 확장 미니포트 어댑터에서 NetEventSwitchActivateNET_PNP_EVENT를 실행하면 확장에서 OID를 발급합니다.
다양한 OID 집합의 OID_SWITCH_PORT_CREATE 및 OID_SWITCH_PORT_DELETE 요청을 검사합니다.
NDIS_SWITCH_NIC_PARAMETERS 구조의 인덱스 멤버는 연결 알림이 만들어지는 네트워크 어댑터의 인덱스를 지정합니다. 지정된 인덱 스 값이 있는 네트워크 어댑터는 PortId 멤버가 지정한 확장 가능한 스위치 포트에 연결됩니다. 이러한 인덱스 값에 대한 자세한 내용은 네트워크 어댑터 인덱스 값을 참조하세요.
OID_SWITCH_NIC_CONNECT OID 집합 요청을 받으면 확장은 다음 지침을 따라야 합니다.
NDIS_STATUS_SUCCESS OID_SWITCH_NIC_CONNECT 요청이 완료되면 네트워크 연결 및 확장 가능한 스위치 포트가 완전히 작동합니다. 확장은 포트의 네트워크 연결에 패킷 트래픽을 생성하거나 전달할 수 있습니다. 확장은 포트를 원본 포트로 사용하는 확장 가능한 스위치 OID 또는 상태 표시를 실행할 수도 있습니다. 또한 확장은 ReferenceSwitchPort 를 호출하여 포트에 대한 확장 가능한 스위치 참조 카운터를 증분할 수 있습니다.
확장은 OID 요청과 연결된 NDIS_SWITCH_NIC_PARAMETERS 구조를 수정해서는 안됩니다.
이 OID 요청을 기본 확장으로 전달하려면 항상 NdisFOidRequest 를 호출해야 합니다. 확장은 OID 요청 자체를 완료하지 않아야 합니다.
확장 가능한 스위치 외부 네트워크 어댑터는 하나 이상의 기본 물리적 어댑터에 바인딩할 수 있습니다. 외부 네트워크 어댑터에 바인딩된 모든 실제 네트워크 어댑터의 경우 확장 가능한 스위치의 프로토콜 에지가 OID_SWITCH_NIC_CONNECT 별도의 OID 집합 요청을 실행합니다. 각 OID 집합 요청은 다른 네트워크 어댑터 연결 인덱스 값을 지정합니다. 이러한 값에 대한 자세한 내용은 네트워크 어댑터 인덱스 값을 참조하세요.
확장은 외부 네트워크 어댑터에 바인딩된 각 기본 물리적 어댑터에 대한 연결 상태를 유지해야 합니다. 물리적 네트워크 어댑터를 외부 네트워크 어댑터에 바인딩할 수 있는 다양한 구성에 대한 자세한 내용은 물리적 네트워크 어댑터 구성 유형을 참조하세요.
참고 확장은 OID_SWITCH_NIC_CONNECT 자체 OID 집합 요청을 실행해서는 안 됩니다.
확장 가능한 스위치 포트 및 네트워크 어댑터 연결 상태에 대한 자세한 내용은 Hyper-V 확장 가능한 스위치 포트 및 네트워크 어댑터 상태를 참조하세요.
반환 상태 코드
확장 가능한 스위치의 기본 미니포트 에지는 OID_SWITCH_NIC_CONNECT OID 집합 요청을 완료하고 다음 상태 코드를 반환합니다.
| 상태 코드 | 설명 |
|---|---|
NDIS_STATUS_SUCCESS |
OID 요청이 성공적으로 완료되었습니다. |
요구 사항
Version |
NDIS 6.30 이상에서 지원됩니다. |
헤더 |
Ntddndis.h(Ndis.h 포함) |