OID_QOS_PARAMETERS

아티클
06/15/2023

DCB(데이터 센터 브리징) 구성 요소(Msdcb.sys)는 네트워크 어댑터에서 로컬 NDIS QoS(서비스 품질) 매개 변수를 구성하기 위해 OID_QOS_PARAMETERS OID(개체 식별자) 메서드 요청을 실행합니다.

NDIS_OID_REQUEST 구조체의 InformationBuffer 멤버는 NDIS_QOS_PARAMETERS 구조체에 대한 포인터를 포함합니다.

참고 이 OID 메서드 요청은 IEEE 802.1 DCB(Data Center Bridging) 인터페이스에 대해 NDIS QoS를 지원하는 미니포트 드라이버에 필수입니다.

설명

미니포트 드라이버는 OID_QOS_PARAMETERS OID 메서드 요청을 통해 로컬 NDIS QoS 매개 변수를 가져옵니다. 이러한 매개 변수는 네트워크 어댑터가 패킷 전송 또는 송신의 우선 순위를 지정하는 방법을 정의합니다. 이러한 매개 변수에 대한 자세한 내용은 NDIS QoS 매개 변수 개요를 참조하세요.

참고 DCB 구성 요소만 OID_QOS_PARAMETERS OID 메서드 요청을 실행할 수 있습니다. 지나치게 많은 프로토콜 또는 필터 드라이버는 이 OID를 실행해서는 안됩니다. DCB 구성 요소에 대한 자세한 내용은 데이터 센터 브리징을 위한 NDIS QoS 아키텍처를 참조하세요.

DCB 구성 요소는 다음 조건에서 OID_QOS_PARAMETERS 요청을 실행합니다.

시스템 관리자는 Microsoft DCB 서버 기능을 설치하거나 제거합니다.

DCB 서버 기능에 대한 자세한 내용은 시스템 제공 DCB 구성 요소를 참조하세요.
시스템 관리자는 기능이 여전히 설치되어 있는 동안 DCB 서버 기능을 사용하거나 사용하지 않도록 설정합니다.
시스템 관리자는 DCB 서버 기능 매개 변수를 변경합니다.
DCB 서버 기능이 설치된 동안 운영 체제가 시작되거나 다시 시작됩니다.

미니포트 드라이버가 OID_QOS_PARAMETERS OID 메서드 요청을 처리하는 경우 다음 지침을 따라야 합니다.

미니포트 드라이버는 NDIS_QOS_PARAMETERS 구조 내의 데이터를 로컬 NDIS QoS 매개 변수의 캐시에 복사합니다. 그런 다음, 드라이버는 로컬 NDIS QoS 매개 변수의 캐시와 원격 피어에서 받은 NDIS QoS 매개 변수의 캐시를 기반으로 운영 NDIS QoS 매개 변수를 확인합니다.

미니포트 드라이버가 작동 매개 변수를 확인하는 방법에 대한 자세한 내용은 운영 NDIS QoS 매개 변수 해결을 참조하세요.
미니포트 드라이버는 NDIS_QOS_PARAMETERS 구조에 포함된 데이터를 수정해서는 안됩니다. 드라이버는 OID 메서드 요청을 완료하고 NDIS_QOS_PARAMETERS 구조 내에서 원래 데이터를 반환해야 합니다.
NDIS_QOS_PARAMETERS_WILLING 플래그는 미니포트 드라이버가 로컬 DCBX(Data Center Bridging Exchange) Willing 상태를 사용하거나 사용하지 않도록 설정할지 여부를 지정합니다. 드라이버는 다음과 같은 방법으로 이 플래그를 처리합니다.
- 이 플래그가 설정된 경우 미니포트 드라이버는 로컬 DCBX Willing 상태를 사용하도록 설정해야 합니다. 이렇게 하면 QoS 설정을 사용하여 드라이버를 원격으로 구성할 수 있습니다. 이 경우 드라이버는 원격 QoS 매개 변수를 기반으로 작동 QoS 매개 변수를 확인합니다. 미니포트 드라이버는 IHV(독립 하드웨어 공급업체)에서 정의한 모든 독점 QoS 설정에 따라 작동 QoS 매개 변수를 resolve 수도 있습니다.
- 이 플래그가 설정되지 않은 경우 미니포트 드라이버는 로컬 DCBX Willing 상태를 사용하지 않도록 설정해야 합니다. 이렇게 하면 드라이버가 원격 QoS 매개 변수 대신 로컬 QoS 매개 변수에서 작동 QoS 매개 변수를 resolve 수 있습니다. 또한 미니포트 드라이버는 관련 NDIS_QOS_PARAMETERS_Xxx_CONFIGURED 플래그가 설정되지 않은 로컬 QoS 매개 변수를 사용하지 않도록 설정하거나 재정의해야 합니다.
  
  예를 들어 미니포트 드라이버는 IHV에서 정의한 QoS 매개 변수에 대한 전용 설정으로 구성되지 않은 로컬 QoS 매개 변수를 재정의할 수 있습니다. NDIS_QOS_PARAMETERS_Xxx_CONFIGURED 플래그로 지정되지 않은 로컬 QoS 매개 변수에 대한 독점 설정이 없는 경우 드라이버는 네트워크 어댑터에서 이러한 QoS 매개 변수의 사용을 사용하지 않도록 설정해야 합니다.
  
  참고 또한 드라이버는 네트워크 어댑터에서 사용하도록 설정된 프로토콜 또는 기술에 사용되는 QoS 매개 변수를 손상시키는 경우 구성된 로컬 QoS 매개 변수를 재정의할 수 있습니다. 예를 들어 네트워크 어댑터가 FCoE(파이버 채널 over Ethernet) 프로토콜을 통해 원격 부팅에 사용하도록 설정된 경우 드라이버는 로컬 QoS 매개 변수를 재정의할 수 있습니다.
로컬 DCBX Willing 상태에 대한 자세한 내용은 로컬 DCBX 의지 상태 관리를 참조하세요.

미니포트 드라이버가 로컬 QoS 매개 변수를 재정의하는 방법에 대한 자세한 내용은 NDIS QoS 매개 변수 관리를 참조하세요.

참고 로컬 QoS 매개 변수를 재정의하면 미니포트 드라이버가 OID_QOS_PARAMETERS OID 메서드 요청에 실패하지 않아야 합니다.

미니포트 드라이버가 로컬 QoS 매개 변수를 관리하는 방법에 대한 자세한 내용은 로컬 NDIS QoS 매개 변수 설정을 참조하세요.

반환 상태 코드

미니포트 드라이버는 다음 상태 코드 중 하나를 반환합니다.

상태 코드	Description
NDIS_STATUS_SUCCESS	OID 요청이 성공적으로 완료되었습니다.
NDIS_STATUS_PENDING	OID 요청이 완료될 때까지 보류 중입니다. 미니포트 드라이버가 NdisMOidRequestComplete를 호출하면 NDIS는 요청이 완료된 후 최종 상태 코드와 결과를 호출자의 OID 요청 완료 처리기에 전달합니다.
NDIS_STATUS_NOT_SUPPORTED	미니포트 드라이버는 NDIS QoS 인터페이스를 지원하지 않습니다.
NDIS_STATUS_INVALID_PARAMETER	NDIS_QOS_PARAMETERS 구조체의 하나 이상의 멤버에 잘못된 값이 포함되어 있습니다.
NDIS_STATUS_INVALID_LENGTH	정보 버퍼의 길이가 sizeof(NDIS_QOS_PARAMETERS)보다 작습니다. NDIS는 데이터를 설정합니다 . QUERY_INFORMATION. 필요한 최소 버퍼 크기에 대한 NDIS_OID_REQUEST 구조체의 BytesNeeded 멤버입니다.
NDIS_STATUS_FAILURE	다른 이유로 인해 요청이 실패했습니다.