사용자 지정 스위치 기능 상태 정보 관리

  • 아티클

Hyper-V 확장 가능한 스위치 인터페이스는 다음 OID(개체 식별자)를 사용하여 확장 가능한 스위치에 대한 사용자 지정 상태 정보를 쿼리합니다. 이 상태 정보는 스위치 기능 상태 정보라고 합니다.

OID_SWITCH_FEATURE_STATUS_QUERY
이 OID 메서드 요청은 지정된 switch 속성에 대한 사용자 지정 기능 상태 정보를 얻기 위해 확장 가능한 스위치의 프로토콜 에지에 의해 발급됩니다.

이 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_QUERY OID 메서드 요청을 받을 때 다음 지침을 따라야 합니다.

  • 확장은 NDIS_SWITCH_FEATURE_STATUS_PARAMETERS 구조체의 FeatureStatusId 멤버와 일치하는 사용자 지정 확장 가능한 스위치 기능 상태 관리하는 경우 OID 요청을 처리해야 합니다.

  • 확장이 OID 메서드 요청을 처리하는 경우 NDIS_SWITCH_FEATURE_STATUS_PARAMETERS 구조에서 지정한 매개 변수와 일치하는 기능 상태 정보를 반환해야 합니다.

    기능 상태 버퍼가 너무 작으면 확장이 NDIS_STATUS_INVALID_LENGTH OID 요청에 실패해야 합니다. 확장은 DATA를 설정해야 합니다 . SET_INFORMATION. 필요한 최소 버퍼 크기에 대한 NDIS_OID_REQUEST 구조체의 BytesNeeded 멤버입니다.

    그렇지 않으면 확장에서 기능 상태 정보를 반환하고 NDIS_STATUS_SUCCESS 사용하여 OID 요청을 완료해야 합니다.

  • 확장이 상태 사용자 지정 확장 가능한 스위치 기능을 관리하지 않는 경우 NdisFOidRequest를 호출하여 확장 가능한 스위치 드라이버 스택 아래로 OID 요청을 전달해야 합니다.

    OID 요청을 전달하는 방법에 대한 자세한 내용은 NDIS 필터 드라이버에서 OID 요청 필터링을 참조하세요.

스위치 기능 상태 정의하고 등록하는 방법에 대한 자세한 내용은 사용자 지정 스위치 기능 상태를 참조하세요.