OID_QOS_PARAMETERS
Komponenta přemostění datového centra (Msdcb.sys) vydává požadavek metody identifikátoru objektu (OID) OID_QOS_PARAMETERS ke konfiguraci místních parametrů QoS (Quality of Service) NDIS na síťovém adaptéru.
InformationBuffer člen struktury NDIS_OID_REQUEST obsahuje ukazatel na NDIS_QOS_PARAMETERS strukturu.
Poznámka Tato žádost o metodu OID je povinná pro ovladače miniportu, které podporují technologii QoS NDIS pro rozhraní přemostění datového centra IEEE 802.1 (DCB).
Poznámky
Ovladače miniportu získávají místní parametry QoS NDIS prostřednictvím požadavku metody OID OID_QOS_PARAMETERS. Tyto parametry definují, jak síťový adaptér určuje prioritu přenosu nebo odchozích přenosů, paketů. Další informace o těchto parametrech najdete v tématu Přehled parametrů QoS NDIS.
Poznámka Pouze komponenta DCB může vydat požadavek metody OID OID_QOS_PARAMETERS. Přílišný protokol nebo ovladač filtru nesmí tento identifikátor OID vydávat. Další informace o komponentě DCB najdete v tématu architektura QoS NDIS pro přemostění datového centra.
Komponenta DCB vydává požadavek OID_QOS_PARAMETERS za následujících podmínek:
Správce systému nainstaluje nebo odinstaluje funkci serveru Microsoft DCB.
Další informace o funkci serveru DCB naleznete v tématu System-Provided komponenty DCB.
Správce systému povolí nebo zakáže funkci serveru DCB, i když je tato funkce stále nainstalovaná.
Správce systému změní některý z parametrů funkce serveru DCB.
Operační systém se spustí nebo restartuje, když je nainstalovaná funkce serveru DCB.
Pokud ovladač miniportu zpracovává požadavek metody OID OID_QOS_PARAMETERS, musí postupovat podle těchto pokynů:
Ovladač miniportu zkopíruje data v rámci struktury NDIS_QOS_PARAMETERS do mezipaměti místních parametrů QoS NDIS. Ovladač pak vyřeší své provozní parametry QoS NDIS na základě mezipaměti místních parametrů QoS NDIS a mezipaměti parametrů QoS NDIS, které přijal od vzdáleného partnerského vztahu.
Další informace o tom, jak ovladač miniportu řeší své provozní parametry, najdete v tématu Řešení provozních parametrů QoS NDIS.
Ovladač miniportu nesmí upravovat žádná data obsažená ve struktuře NDIS_QOS_PARAMETERS. Ovladač musí dokončit požadavek na metodu OID a vrátit původní data v rámci struktury NDIS_QOS_PARAMETERS.
Příznak NDIS_QOS_PARAMETERS_WILLING určuje, jestli ovladač miniportu povolí nebo zakáže místní stav přemostění datacentra (DCBX) Willing. Ovladač zpracovává tento příznak následujícím způsobem:
Pokud je tento příznak nastavený, musí ovladač miniportu povolit místní stav DCBX Willing. To umožňuje vzdálené konfiguraci ovladače pomocí nastavení QoS. V tomto případě ovladač vyřeší své provozní parametry QoS na základě vzdálených parametrů QoS. Ovladač miniportu dokáže také vyřešit provozní parametry QoS na základě všech proprietárních nastavení QoS definovaných nezávislým dodavatelem hardwaru (IHV).
Pokud tento příznak není nastavený, ovladač miniportu musí zakázat místní stav DCBX Willing. To umožňuje ovladači přeložit provozní parametry QoS z místních parametrů QoS místo vzdálených parametrů QoS. Ovladač miniportu musí také zakázat nebo přepsat jakýkoli místní parametr QoS, pro který související NDIS_QOS_PARAMETERS_Xxx_CONFIGURED příznak není nastaven.
Například ovladač miniportu může přepsat nekonfigurovaný místní parametr QoS s jeho proprietárním nastavením pro parametr QoS, který je definován IHV. Pokud neexistují žádná proprietární nastavení pro místní parametry QoS, které nejsou zadány příznakem NDIS_QOS_PARAMETERS_Xxx_CONFIGURED, ovladač musí zakázat použití těchto parametrů QoS na síťovém adaptéru.
Poznámka Ovladač může také přepsat nakonfigurované místní parametry QoS, pokud ohrožují parametry QoS používané protokoly nebo technologiemi povolenými na síťovém adaptéru. Ovladač může například přepsat místní parametry QoS, pokud je síťový adaptér povolený pro vzdálené spouštění prostřednictvím protokolu FCoE (Fibre Channel over Ethernet).
Další informace o místním stavu DCBX Willing naleznete v tématu Správa místního DCBX Willing State.
Další informace o tom, jak ovladač miniportu přepisuje místní parametry QoS, najdete v tématu Správa parametrů QoS NDIS.
Poznámka: Přepsání místních parametrů QoS by nemělo způsobit selhání ovladače miniportu požadavek metody OID OID_QOS_PARAMETERS.
Další informace o tom, jak ovladač miniportu spravuje místní parametry QoS, najdete v tématu Nastavení místních parametrů QoS NDIS.
Návratové stavové kódy
Ovladač miniportu vrátí jeden z následujících stavových kódů.
Stavový kód | Popis |
---|---|
NDIS_STATUS_SUCCESS |
Požadavek OID byl úspěšně dokončen. |
NDIS_STATUS_PENDING |
Požadavek OID čeká na dokončení. Když ovladač miniportu volá NdisMOidRequestComplete, NDIS předá konečný stavový kód a výsledky obslužné rutině dokončení požadavku OID volajícího po dokončení požadavku. |
NDIS_STATUS_NOT_SUPPORTED |
Ovladač miniportu nepodporuje rozhraní QoS NDIS. |
NDIS_STATUS_INVALID_PARAMETER |
Nejméně jeden člen struktury NDIS_QOS_PARAMETERS obsahuje nesprávné hodnoty. |
NDIS_STATUS_INVALID_LENGTH |
Délka vyrovnávací paměti informací je menší než velikost(NDIS_QOS_PARAMETERS). Rozhraní NDIS nastaví DATA. QUERY_INFORMATION. BytesNeeded člen ve struktuře NDIS_OID_REQUEST na minimální požadovanou velikost vyrovnávací paměti. |
NDIS_STATUS_FAILURE |
Žádost se nezdařila z jiných důvodů. |
Požadavky
Verze |
Podporováno v NDIS 6.30 a novějších verzích. |
Záhlaví |
Ntddndis.h (včetně Ndis.h) |