Wyliczanie przełączników dla karty sieciowej
Nadrzędny sterownik lub aplikacja użytkownika może uzyskać listę wszystkich przełączników kart sieciowych utworzonych na karcie sieciowej obsługującej wirtualizację we/wy z pojedynczym elementem głównym (SR-IOV). Sterownik lub aplikacja wystawia żądanie zapytania o identyfikator obiektu (OID) OID_NIC_SWITCH_ENUM_SWITCHES, aby uzyskać tę listę.
Po udanym zakończeniu tego żądania OID, członek InformationBuffer elementu struktury NDIS_OID_REQUEST zawiera wskaźnik wskazujący na bufor, który zawiera 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 NIC 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.
Uwaga Począwszy od systemu Windows Server 2012, interfejs SR-IOV obsługuje tylko jeden przełącznik sieciowy na karcie sieciowej. Ten przełącznik jest znany jako domyślny przełącznik NIC i jest przywoływany przez identyfikator NDIS_DEFAULT_SWITCH_ID.
Usługa NDIS obsługuje żądanie OID_NIC_SWITCH_ENUM_SWITCHES dla sterowników miniportu. NDIS zwraca informacje z wewnętrznej pamięci podręcznej, które utrzymuje z następujących źródeł:
Ustandaryzowane ustawienia słowa kluczowego SR-IOV w rejestrze. Aby uzyskać więcej informacji na temat tych słów kluczowych, zobacz Ustandaryzowane słowa kluczowe INF dla SR-IOV .
Żądania OID OID_NIC_SWITCH_CREATE_SWITCH i OID_NIC_SWITCH_PARAMETERS.
Uwaga NDIS również umożliwia wyliczenie przełączników w składowej NicSwitchArray, znajdującej się w strukturach NDIS_BIND_PARAMETERS oraz NDIS_FILTER_ATTACH_PARAMETERS. W związku z tym nadrzędny protokół i sterowniki filtrów nie muszą wysyłać OID_NIC_SWITCH_ENUM_SWITCHES żądania, aby uzyskać te informacje.