OID_NIC_SWITCH_DELETE_VPORT
오버리싱 드라이버는 이전에 네트워크 어댑터의 NIC 스위치에서 만든 기본이 아닌 VPort(가상 포트)를 삭제하기 위해 OID_NIC_SWITCH_DELETE_VPORT OID(개체 식별자) 집합 요청을 실행합니다. 오버리싱 드라이버는 OID_NIC_SWITCH_CREATE_VPORT OID 메서드 요청을 실행하여 이전에 만든 VPort를 삭제할 수 있습니다.
오버리싱 드라이버는 네트워크 어댑터의 PCIe PF(물리적 함수)에 대한 미니포트 드라이버에 이 OID 집합 요청을 실행합니다. 이 OID 집합 요청은 단일 루트 I/O 가상화(SR-IOV) 인터페이스를 지원하는 PF 미니포트 드라이버에 필요합니다.
NDIS_OID_REQUEST 구조체의 InformationBuffer 멤버는 NDIS_NIC_SWITCH_DELETE_VPORT_PARAMETERS 구조체에 대한 포인터를 포함합니다.
설명
프로토콜 또는 필터 드라이버와 같은 오버리싱 드라이버는 이전에 만든 기본이 아닌 VPort만 삭제할 수 있습니다. 오버리싱 드라이버는 OID_NIC_SWITCH_CREATE_VPORT OID 메서드 요청을 실행하여 VPort를 만듭니다.
PF 미니포트 드라이버가 OID_NIC_SWITCH_DELETE_VPORT OID 요청을 받으면 드라이버는 지정된 VPort에 할당된 하드웨어 및 소프트웨어 리소스를 해제해야 합니다.
자세한 내용은 가상 포트 삭제를 참조하세요.
참고 기본이 아닌 VPort만 OID_NIC_SWITCH_DELETE_VPORT OID 요청을 통해 명시적으로 삭제할 수 있습니다. PF 미니포트 드라이버가 기본 NIC 스위치를 삭제하면 기본 VPort가 암시적으로 삭제됩니다. 자세한 내용은 NIC 스위치 삭제를 참조하세요.
반환 상태 코드
PF 미니포트 드라이버는 OID_NIC_SWITCH_DELETE_VPORT OID 집합 요청에 대해 다음 상태 코드 중 하나를 반환합니다.
| 상태 코드 | Description |
|---|---|
NDIS_STATUS_SUCCESS |
OID 요청이 성공적으로 완료되었습니다. |
NDIS_STATUS_NOT_SUPPORTED |
PF 미니포트 드라이버는 단일 루트 I/O 가상화(SR-IOV) 인터페이스를 지원하지 않거나 인터페이스를 사용할 수 없습니다. |
NDIS_STATUS_INVALID_PARAMETER |
NDIS_NIC_SWITCH_DELETE_VPORT_PARAMETERS 구조체의 멤버 중 하나 이상에 잘못된 값이 있습니다. |
NDIS_STATUS_INVALID_LENGTH |
정보 버퍼의 길이가 sizeof(NDIS_NIC_SWITCH_DELETE_VPORT_PARAMETERS)보다 작습니다. PF 미니포트 드라이버는 데이터를 설정해야 합니다 . SET_INFORMATION. 필요한 최소 버퍼 크기에 대한 NDIS_OID_REQUEST 구조체의 BytesNeeded 멤버입니다. |
NDIS_STATUS_FAILURE |
다른 이유로 인해 요청이 실패했습니다. |
요구 사항
Version |
NDIS 6.30 이상에서 지원됩니다. |
헤더 |
Ntddndis.h(Ndis.h 포함) |