OID_SWITCH_PORT_PROPERTY_ENUM
Hyper-V 확장 확장은 배열을 가져오기 위해 OID_SWITCH_PORT_PROPERTY_ENUM OID(개체 식별자) 메서드 요청을 실행합니다. 이 배열에는 지정된 조건과 일치하는 프로비전된 포트 정책이 포함됩니다. 배열의 각 요소는 지정된 확장 가능한 스위치 포트에 대한 정책의 속성을 지정합니다.
NDIS_OID_REQUEST 구조체의 InformationBuffer 멤버는 버퍼에 대한 포인터를 포함합니다. 이 버퍼에는 다음 데이터가 포함됩니다.
지정된 포트의 정책 열거에 대한 매개 변수를 지정하는 NDIS_SWITCH_PORT_PROPERTY_ENUM_PARAMETERS 구조체입니다.
NDIS_SWITCH_PORT_PROPERTY_ENUM_INFO 구조체의 배열입니다. 이러한 각 구조에는 확장 가능한 스위치 포트 정책의 속성에 대한 정보가 포함됩니다.
참고NDIS_SWITCH_PORT_PROPERTY_ENUM_PARAMETERS 구조체의 NumProperties 멤버를 0으로 설정하면 NDIS_SWITCH_PORT_PROPERTY_ENUM_INFO 구조체가 반환되지 않습니다.
설명
OID_SWITCH_PORT_PROPERTY_ENUM OID 메서드 요청을 실행하기 전에 확장 가능한 스위치 확장은 다음 지침을 따라야 합니다.
확장은 확장 가능한 스위치의 프로토콜 에지가 OID_SWITCH_PORT_CREATE 요청을 발급하고 OID_SWITCH_PORT_TEARDOWN 요청을 발급하기 전에 만 OID_SWITCH_PORT_PROPERTY_ENUM 요청을 실행할 수 있습니다.
확장은 NdisFOidRequest를 호출하여 OID_SWITCH_PORT_PROPERTY_ENUM 요청을 실행하기 전에 ReferenceSwitchPort를 호출해야 합니다. 이렇게 하면 OID 요청이 완료될 때까지 지정된 포트가 삭제되지 않습니다.
OID 요청이 완료되면 확장은 DereferenceSwitchPort를 호출해야 합니다. 확장은 OID 요청이 NDIS_STATUS_SUCCESS 완료되었는지 여부에 관계없이 이 함수를 호출해야 합니다.
OID_SWITCH_PORT_PROPERTY_ENUM OID는 Hyper-V 확장 가능 스위치가 활성화를 완료한 경우에만 실행되어야 합니다. 자세한 내용은 Hyper-V 확장 가능 스위치 구성 쿼리 를 참조하세요.
참고 확장이 OID_SWITCH_PORT_PROPERTY_ENUM OID 메서드 요청을 수신하는 경우 OID 요청을 완료하면 안 됩니다. 대신 NdisFOidRequest 를 호출하여 확장 가능한 스위치 드라이버 스택 아래로 OID 요청을 전달해야 합니다.
반환 상태 코드
확장 가능한 스위치의 기본 미니포트 에지는 OID_SWITCH_PORT_PROPERTY_ENUM OID 쿼리 요청을 완료하고 다음 상태 코드를 반환합니다.
| 상태 코드 | Description |
|---|---|
NDIS_STATUS_SUCCESS |
OID 요청이 성공적으로 완료되었습니다. |
요구 사항
Version |
NDIS 6.30 이상에서 지원됩니다. |
헤더 |
Ntddndis.h(Ndis.h 포함) |
추가 정보
NDIS_SWITCH_PORT_PROPERTY_ENUM_INFO