OID_QOS_PARAMETERS
Składnik mostkowania centrum danych (DCB) (Msdcb.sys) wystawia żądanie metody identyfikatora obiektu (OID) OID_QOS_PARAMETERS w celu skonfigurowania lokalnych parametrów jakości usługi NDIS (QoS) na karcie sieciowej.
Element InformationBuffer struktury NDIS_OID_REQUEST zawiera wskaźnik do struktury NDIS_QOS_PARAMETERS.
Uwaga To żądanie metody OID jest obowiązkowe dla sterowników miniportu obsługujących funkcję QoS NDIS dla interfejsu mostkowania centrum danych IEEE 802.1 (DCB).
Uwagi
Sterowniki miniportu uzyskują lokalne parametry QoS NDIS za pomocą żądania metody OID OID_QOS_PARAMETERS. Te parametry definiują sposób określania priorytetów transmisji przez kartę sieciową lub wychodzącychpakietów. Aby uzyskać więcej informacji na temat tych parametrów, zobacz Overview of NDIS QoS Parameters (Omówienie parametrów QoS usługi NDIS).
Uwaga Tylko składnik DCB może wydać żądanie metody OID OID_QOS_PARAMETERS. Nadmierny protokół lub sterownik filtru nie może wydać tego identyfikatora OID. Aby uzyskać więcej informacji na temat składnika DCB, zobacz Architektura QoS NDIS dla mostkowania centrum danych.
Składnik DCB wysyła żądanie OID_QOS_PARAMETERS w następujących warunkach:
Administrator systemu instaluje lub odinstalowuje funkcję serwera DCB firmy Microsoft.
Aby uzyskać więcej informacji na temat funkcji serwera DCB, zobacz System-Provided DCB Components.
Administrator systemu włącza lub wyłącza funkcję serwera DCB, gdy funkcja jest nadal zainstalowana.
Administrator systemu zmienia dowolne parametry funkcji serwera DCB.
System operacyjny jest uruchamiany lub uruchamiany ponownie podczas instalowania funkcji serwera DCB.
Gdy sterownik miniportu obsługuje żądanie metody OID OID_QOS_PARAMETERS, musi postępować zgodnie z następującymi wytycznymi:
Sterownik miniportu kopiuje dane w strukturze NDIS_QOS_PARAMETERS do pamięci podręcznej lokalnych parametrów QoS NDIS. Następnie sterownik rozwiązuje swoje operacyjne parametry QoS NDIS na podstawie pamięci podręcznej lokalnych parametrów QoS NDIS i jego pamięci podręcznej parametrów QoS NDIS, które otrzymał od zdalnego elementu równorzędnego.
Aby uzyskać więcej informacji na temat sposobu rozwiązywania parametrów operacyjnych przez sterownik miniportu, zobacz Rozwiązywanie operacyjnych parametrów QoS usługi NDIS.
Sterownik miniportu nie może modyfikować żadnych danych zawartych w strukturze NDIS_QOS_PARAMETERS. Sterownik musi ukończyć żądanie metody OID i zwrócić oryginalne dane w strukturze NDIS_QOS_PARAMETERS.
Flaga NDIS_QOS_PARAMETERS_WILLING określa, czy sterownik miniportu włącza, czy wyłącza lokalny stan bridging Exchange (DCBX). Sterownik obsługuje tę flagę w następujący sposób:
Jeśli ta flaga jest ustawiona, sterownik miniportu musi włączyć lokalny stan DCBX Willing. Dzięki temu sterownik może być zdalnie skonfigurowany przy użyciu ustawień QoS. W takim przypadku sterownik rozwiązuje swoje parametry operacyjne QoS na podstawie zdalnych parametrów QoS. Sterownik miniportu może również rozpoznać jego operacyjne parametry QoS na podstawie wszelkich zastrzeżonych ustawień QoS zdefiniowanych przez niezależnego dostawcę sprzętu (IHV).
Jeśli ta flaga nie jest ustawiona, sterownik miniportu musi wyłączyć lokalny stan DCBX Willing. Dzięki temu sterownik może rozpoznać jego operacyjne parametry QoS z lokalnych parametrów QoS zamiast zdalnych parametrów QoS. Sterownik miniportu musi również wyłączyć lub zastąpić dowolny lokalny parametr QoS, dla którego nie ustawiono powiązanej flagi NDIS_QOS_PARAMETERS_Xxx_CONFIGURED.
Na przykład sterownik miniportu może zastąpić nieskonfigurowany lokalny parametr QoS z jego zastrzeżonymi ustawieniami dla parametru QoS zdefiniowanego przez IHV. Jeśli nie ma żadnych zastrzeżonych ustawień dla lokalnych parametrów QoS, które nie są określone z flagą_CONFIGURED NDIS_QOS_PARAMETERS_Xxx, sterownik musi wyłączyć używanie tych parametrów QoS na karcie sieciowej.
Uwaga Sterownik może również zastąpić skonfigurowane lokalne parametry QoS, jeśli naruszyć parametry QoS używane przez protokoły lub technologie włączone na karcie sieciowej. Na przykład sterownik może zastąpić lokalne parametry QoS, jeśli karta sieciowa jest włączona do zdalnego rozruchu za pośrednictwem protokołu Fibre Channel over Ethernet (FCoE).
Aby uzyskać więcej informacji na temat lokalnego stanu DCBX Willing, zobacz Managing the Local DCBX Willing State.
Aby uzyskać więcej informacji o tym, jak sterownik miniportu zastępuje lokalne parametry QoS, zobacz Managing NDIS QoS Parameters.
Uwaga zastąpienie lokalnych parametrów QoS nie powinno spowodować, że sterownik miniportu zakończy się niepowodzeniem żądania metody OID OID_QOS_PARAMETERS.
Aby uzyskać więcej informacji na temat zarządzania lokalnymi parametrami QoS przez sterownik miniportu, zobacz Setting Local NDIS QoS Parameters.
Kody stanu powrotu
Sterownik miniportu zwraca jeden z następujących kodów stanu.
| Kod stanu | Opis |
|---|---|
NDIS_STATUS_SUCCESS |
Żądanie OID zostało ukończone pomyślnie. |
NDIS_STATUS_PENDING |
Żądanie OID oczekuje na ukończenie. Gdy sterownik miniportu wywołuje NdisMOidRequestComplete, usługa NDIS przekaże końcowy kod stanu i wyniki do procedury obsługi ukończenia żądania OID obiektu wywołującego po zakończeniu żądania. |
NDIS_STATUS_NOT_SUPPORTED |
Sterownik miniportu nie obsługuje interfejsu QoS NDIS. |
NDIS_STATUS_INVALID_PARAMETER |
Co najmniej jeden element członkowny struktury NDIS_QOS_PARAMETERS zawiera nieprawidłowe wartości. |
NDIS_STATUS_INVALID_LENGTH |
Długość buforu informacji jest mniejsza niż rozmiar(NDIS_QOS_PARAMETERS). Usługa NDIS ustawia DATA. QUERY_INFORMATION. BajtyNowe składowe w strukturze NDIS_OID_REQUEST do minimalnego wymaganego rozmiaru buforu. |
NDIS_STATUS_FAILURE |
Żądanie nie powiodło się z innych powodów. |
Wymagania
Wersja |
Obsługiwane w usłudze NDIS 6.30 i nowszych wersjach. |
Nagłówek |
Ntddndis.h (m.in. Ndis.h) |