OID_QOS_PARAMETERS
DcB-komponenten (Data Center Bridging) (Msdcb.sys) utfärdar en OID-metodbegäran (object identifier) för OID_QOS_PARAMETERS för att konfigurera de lokala QoS-parametrarna (NDIS Quality of Service) på ett nätverkskort.
InformationBuffer medlem i NDIS_OID_REQUEST struktur innehåller en pekare till en NDIS_QOS_PARAMETERS struktur.
Obs Denna OID-metodbegäran är obligatorisk för miniportdrivrutiner som stöder NDIS QoS för gränssnittet IEEE 802.1 Data Center Bridging (DCB).
Anmärkningar
Miniportdrivrutiner hämtar de lokala NDIS QoS-parametrarna via en OID-metodbegäran av OID_QOS_PARAMETERS. Dessa parametrar definierar hur nätverkskortet prioriterar överföring, eller utgående, paket. Mer information om dessa parametrar finns i Översikt över NDIS QoS-parametrar.
Obs Endast DCB-komponenten kan utfärda en OID-metodbegäran för OID_QOS_PARAMETERS. Ett överlagringsprotokoll eller en filterdrivrutin får inte utfärda den här OID:en. Mer information om DCB-komponenten finns i NDIS QoS Architecture for Data Center Bridging.
DCB-komponenten utfärdar en OID_QOS_PARAMETERS begäran under följande villkor:
Systemadministratören installerar eller avinstallerar Microsoft DCB-serverfunktionen.
Mer information om DCB-serverfunktionen finns i System-Provided DCB-komponenter.
Systemadministratören aktiverar eller inaktiverar DCB-serverfunktionen medan funktionen fortfarande är installerad.
Systemadministratören ändrar någon av DCB-serverfunktionsparametrarna.
Operativsystemet startar eller startar om medan DCB-serverfunktionen är installerad.
När miniportdrivrutinen hanterar OID-metodens begäran om OID_QOS_PARAMETERS måste den följa dessa riktlinjer:
Miniportdrivrutinen kopierar data i den NDIS_QOS_PARAMETERS strukturen till dess cache med lokala NDIS QoS-parametrar. Drivrutinen löser sedan sina operativa NDIS QoS-parametrar baserat på dess cache med lokala NDIS QoS-parametrar och dess cache med NDIS QoS-parametrar som den tog emot från en fjärransluten peer.
Mer information om hur miniportdrivrutinen löser sina driftparametrar finns i Resolveing Operational NDIS QoS Parameters.
Miniportdrivrutinen får inte ändra några data som finns i NDIS_QOS_PARAMETERS struktur. Drivrutinen måste slutföra OID-metodbegäran och returnera ursprungliga data i NDIS_QOS_PARAMETERS struktur.
Flaggan NDIS_QOS_PARAMETERS_WILLING anger om miniportdrivrutinen aktiverar eller inaktiverar det lokala DCBX-tillståndet (Data Center Bridging Exchange). Drivrutinen hanterar den här flaggan på följande sätt:
Om den här flaggan har angetts måste miniportdrivrutinen aktivera det lokala DCBX Willing-tillståndet. Detta gör att drivrutinen kan konfigureras via fjärranslutning med QoS-inställningar. I det här fallet löser drivrutinen sina operativa QoS-parametrar baserat på QoS-fjärrparametrarna. Miniportdrivrutinen kan också lösa sina operativa QoS-parametrar baserat på eventuella proprietära QoS-inställningar som definieras av den oberoende maskinvaruleverantören (IHV).
Om den här flaggan inte har angetts måste miniportdrivrutinen inaktivera det lokala DCBX Willing-tillståndet. Detta gör att drivrutinen kan matcha sina operativa QoS-parametrar från sina lokala QoS-parametrar i stället för QoS-fjärrparametrar. Miniportdrivrutinen måste också inaktivera eller åsidosätta en lokal QoS-parameter för vilken den relaterade flaggan NDIS_QOS_PARAMETERS_Xxx_CONFIGURED inte har angetts.
Miniportdrivrutinen kan till exempel åsidosätta en okonfigurerad lokal QoS-parameter med sina egna inställningar för QoS-parametern som definieras av IHV. Om det inte finns några egna inställningar för lokala QoS-parametrar som inte har angetts med flaggan NDIS_QOS_PARAMETERS_Xxx_CONFIGURED måste drivrutinen inaktivera användningen av dessa QoS-parametrar på nätverkskortet.
Obs Drivrutinen kan också åsidosätta konfigurerade lokala QoS-parametrar om de komprometterar QoS-parametrarna som används av protokoll eller tekniker som är aktiverade på nätverkskortet. Drivrutinen kan till exempel åsidosätta de lokala QoS-parametrarna om nätverkskortet är aktiverat för fjärrstart via FCoE-protokollet (Fibre Channel over Ethernet).
Mer information om det lokala DCBX Willing-tillståndet finns i Hantera den lokala DCBX Willing State-.
Mer information om hur miniportdrivrutinen åsidosätter lokala QoS-parametrar finns i Hantera NDIS QoS-parametrar.
Observera åsidosätta de lokala QoS-parametrarna bör inte orsaka att miniportdrivrutinen misslyckas med OID-metodbegäran för OID_QOS_PARAMETERS.
Mer information om hur miniportdrivrutinen hanterar de lokala QoS-parametrarna finns i Ange lokala NDIS QoS-parametrar.
Returstatuskoder
Miniportdrivrutinen returnerar någon av följande statuskoder.
| Statuskod | Beskrivning |
|---|---|
NDIS_STATUS_SUCCESS |
OID-begäran har slutförts. |
NDIS_STATUS_PENDING |
OID-begäran väntar på att slutföras. När miniportdrivrutinen anropar NdisMOidRequestCompleteskickar NDIS den slutliga statuskoden och resultaten till OID-begärans slutförandehanterare för anroparen när begäran har slutförts. |
NDIS_STATUS_NOT_SUPPORTED |
Miniportdrivrutinen stöder inte NDIS QoS-gränssnittet. |
NDIS_STATUS_INVALID_PARAMETER |
En eller flera medlemmar i NDIS_QOS_PARAMETERS struktur innehåller felaktiga värden. |
NDIS_STATUS_INVALID_LENGTH |
Informationsbuffertens längd är mindre än storlek på(NDIS_QOS_PARAMETERS). NDIS anger DATA. QUERY_INFORMATION. BytesNeeded medlem i NDIS_OID_REQUEST struktur till den minsta buffertstorlek som krävs. |
NDIS_STATUS_FAILURE |
Begäran misslyckades av andra skäl. |
Krav
Version |
Stöds i NDIS 6.30 och senare. |
Rubrik |
Ntddndis.h (inkludera Ndis.h) |