OID_NIC_SWITCH_ENUM_SWITCHES

Nadmierny sterownik lub aplikacja trybu użytkownika wystawia żądanie zapytania identyfikatora obiektu (OID) OID_NIC_SWITCH_ENUM_SWITCHES w celu uzyskania tablicy. Każdy element w tablicy określa atrybuty przełącznika karty sieciowej, który został utworzony na karcie sieciowej.

Po pomyślnym powrocie z tego żądania zapytania OID InformationBuffer struktury NDIS_OID_REQUEST zawiera wskaźnik do buforu zawierającego następujące elementy:

• Struktura NDIS_NIC_SWITCH_INFO_ARRAY, która definiuje liczbę elementów w tablicy.

• Tablica struktur NDIS_NIC_SWITCH_INFO. Każda z tych struktur zawiera informacje dotyczące pojedynczego przełącznika sieciowego utworzonego na karcie sieciowej.

  Uwaga Jeśli karta sieciowa nie ma przełączników kart sieciowych, sterownik ustawia NumElements składowej struktury NDIS_NIC_SWITCH_INFO_ARRAY na zero i nie są zwracane żadne struktury NDIS_NIC_SWITCH_INFO.

Uwagi

Nadmierne sterowniki i aplikacje w trybie użytkownika wystawiają żądania zapytań OID OID_NIC_SWITCH_ENUM_SWITCHES w celu wyliczenia przełączników kart interfejsu sieciowego utworzonych na karcie sieciowej.

Uwaga Począwszy od systemu Windows Server 2012, jeden główny interfejs wirtualizacji we/wy (SR-IOV) obsługuje tylko domyślny przełącznik kart sieciowych na karcie sieciowej. W związku z tym zwrócona struktura NDIS_NIC_SWITCH_INFO_ARRAY musi określać pojedynczy element NDIS_NIC_SWITCH_INFO dla domyślnego przełącznika karty sieciowej, do którego odwołuje się identyfikator NDIS_DEFAULT_SWITCH_ID.

Kody stanu powrotu

Usługa NDIS obsługuje żądanie zapytania OID OID_NIC_SWITCH_ENUM_SWITCHES dla sterowników miniportu. Sterowniki nie będą wystawiane tego żądania identyfikatora OID.

Gdy usługa NDIS obsługuje żądanie OID_NIC_SWITCH_ENUM_SWITCHES, 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_NOT_SUPPORTED	Sterownik miniportu nie obsługuje interfejsu SR-IOV lub nie jest włączony do korzystania z interfejsu.
NDIS_STATUS_INVALID_PARAMETER	Co najmniej jeden z elementów członkowskich struktury NDIS_NIC_SWITCH_INFO_ARRAY ma nieprawidłowe wartości.
NDIS_STATUS_INVALID_LENGTH	Bufor informacyjny był zbyt krótki. 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)

Zobacz też

---

NDIS_NIC_SWITCH_INFO

NDIS_NIC_SWITCH_INFO_ARRAY

NDIS_OID_REQUEST

OID_NIC_SWITCH_CREATE_SWITCH

OID_NIC_SWITCH_PARAMETERS