OID_SWITCH_NIC_ARRAY
Rozszerzenie przełącznika rozszerzalnego Hyper-V wystawia żądanie zapytania identyfikatora obiektu (OID) OID_SWITCH_NIC_ARRAY w celu uzyskania tablicy. Każdy element w tablicy określa parametry konfiguracji wirtualnej karty sieciowej skojarzonej z rozszerzalnym portem przełącznika.
Jeśli żądanie zapytania OID zostało ukończone pomyślnie, InformationBuffer element członkowski struktury NDIS_OID_REQUEST zawiera wskaźnik do buforu. Ten bufor zawiera następujące dane:
Struktura NDIS_SWITCH_NIC_ARRAY, która definiuje liczbę elementów w tablicy. Ta struktura określa również przesunięcie do pierwszego elementu w tablicy.
Tablica struktur NDIS_SWITCH_NIC_PARAMETERS. Każda z tych struktur zawiera informacje o karcie sieciowej połączonej z rozszerzalnym portem przełącznika.
Uwaga Jeśli żadne karty sieciowe nie są podłączone do rozszerzalnych portów przełącznika, podstawowa krawędź miniportu przełącznika rozszerzalnego ustawia NumElements składowej struktury NDIS_SWITCH_NIC_ARRAY na zero. W tym przypadku nie są zwracane żadne struktury NDIS_SWITCH_NIC_PARAMETERS.
Uwagi
OID_SWITCH_NIC_ARRAY OID musi być wystawiany tylko wtedy, gdy przełącznik rozszerzalny Hyper-V zakończył aktywację. Aby uzyskać więcej informacji, zobacz Wykonywanie zapytań dotyczących konfiguracji przełącznika rozszerzalnego Hyper-V.
Gdy rozszerzenie przetwarza zwróconą strukturę NDIS_SWITCH_NIC_PARAMETERS, nie może zakładać, że różne elementy członkowskie ciągu struktury NDIS_SWITCH_PORT_PARAMETERS, takie jak NicFriendlyName, są zakończone wartością NULL. Typy danych dla tych składowych ciągów są definiowane przez strukturę IF_COUNTED_STRING. Sterownik musi określić długość ciągu z wartości Length składowej tej struktury.
Uwaga Jeśli ciąg jest zakończony wartością null, element członkowski długości nie może zawierać znaku null zakończenia.
Kody stanu powrotu
Podstawowa krawędź miniportu przełącznika rozszerzalnego kończy żądanie zapytania OID OID_SWITCH_NIC_ARRAY i 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_INVALID_LENGTH |
Długość buforu informacji jest zbyt mała, aby zwrócić NDIS_SWITCH_NIC_ARRAY i jego tablicę NDIS_SWITCH_NIC_PARAMETERS elementów. Podstawowa krawędź miniportu przełącznika rozszerzalnego 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ż
wykonywanie zapytań dotyczących konfiguracji przełącznika rozszerzalnego Hyper-V