Hyper-V 확장 가능한 스위치 인터페이스는 다음 OID(개체 식별자)를 사용하여 확장 가능한 스위치에 대한 사용자 지정 상태 정보를 쿼리합니다. 이 상태 정보를 스위치 기능 상태 정보라고 합니다.
OID_스위치_기능_상태_조회
이 OID 메서드 요청은 지정된 스위치 속성에 대한 사용자 지정 기능 상태 정보를 얻기 위해 확장 가능한 스위치의 프로토콜 에지에 의해 발급됩니다.
이 OID 메서드 요청에서 성공적으로 반환되면 NDIS_OID_REQUEST 구조체의 InformationBuffer 멤버에 버퍼에 대한 포인터가 포함됩니다. 이 버퍼에는 다음 데이터가 포함됩니다.
반환할 사용자 지정 기능 상태 정보를 지정하는 NDIS_SWITCH_FEATURE_STATUS_PARAMETERS 구조체입니다.
참고 사용자 지정 기능 상태의 경우 FeatureStatusType 멤버가 NdisSwitchPropertyTypeCustom로 설정됩니다.
확장 가능한 스위치 포트에 할당된 사용자 지정 속성에 대한 상태 정보를 포함하는 NDIS_SWITCH_FEATURE_STATUS_CUSTOM 구조체입니다.
확장 가능한 스위치의 프로토콜 에지가 OID_SWITCH_FEATURE_STATUS_QUERY 요청을 발급하면, FeatureStatusCustomBufferLength를 설정하고 FeatureStatusCustomBufferOffset 멤버를 InformationBuffer 멤버의 위치로 설정하여, 확장이 기능 상태 정보를 반환할 수 있습니다.
확장 가능한 스위치 확장은 OID_SWITCH_FEATURE_STATUS_QUERYOID 메서드 요청을 받을 때 다음 지침을 따라야 합니다.
확장은 NDIS_SWITCH_FEATURE_STATUS_PARAMETERS 구조의 FeatureStatusId 멤버와 일치하는 사용자 지정 확장 가능한 스위치 기능 상태를 관리하는 경우 OID 요청을 처리해야 합니다.
확장에서 OID 메서드 요청을 처리하는 경우 NDIS_SWITCH_FEATURE_STATUS_PARAMETERS 구조에서 지정한 매개 변수와 일치하는 기능 상태 정보를 반환해야 합니다.
기능 상태 버퍼가 너무 작으면 확장이 NDIS_STATUS_INVALID_LENGTH OID 요청에 실패해야 합니다. 확장은 NDIS_OID_REQUEST 구조체의 DATA.SET_INFORMATION.BytesNeeded 멤버를 필요한 최소 버퍼 크기로 설정해야 합니다.
그렇지 않으면 확장에서 기능 상태 정보를 반환하고 NDIS_STATUS_SUCCESS OID 요청을 완료해야 합니다.
확장에서 사용자 지정 확장 가능한 스위치 기능 상태를 관리하지 않는 경우 NdisFOidRequest 호출하여 확장 가능한 스위치 드라이버 스택 아래로 OID 요청을 전달해야 합니다.
OID 요청을 전달하는 방법에 대한 자세한 내용은 NDIS 필터 드라이버에서 OID 요청 필터링을 참조하세요.
스위치 기능 상태 정보를 정의하고 등록하는 방법에 대한 자세한 내용은 사용자 지정 스위치 기능 상태참조하세요.