OID_SWITCH_PORT_ARRAY

Rozszerzenie przełącznika rozszerzalnego Hyper-V wystawia żądanie zapytania identyfikatora obiektu (OID) OID_SWITCH_PORT_ARRAY w celu uzyskania tablicy. Każdy element w tablicy określa parametry konfiguracji dla rozszerzalnego portu przełącznika.

Jeśli żądanie zapytania OID zakończy się pomyślnie, element członkowski InformationBuffer struktury NDIS_OID_REQUEST zawiera wskaźnik do buforu. Ten bufor zawiera następujące dane:

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

• Tablica struktur NDIS_SWITCH_PORT_PARAMETERS. Każda z tych struktur zawiera informacje o porcie na rozszerzalnym przełączniku.

  Uwaga Jeśli na przełączniku rozszerzalnym nie utworzono żadnych portów, sterownik ustawia NumElements składowej struktury NDIS_SWITCH_PORT_ARRAY na zero i nie są zwracane żadne struktury NDIS_SWITCH_PORT_PARAMETERS.

Uwagi

OID_SWITCH_PORT_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 obsługuje zwracaną strukturę NDIS_SWITCH_PORT_PARAMETERS, nie może zakładać, że różne elementy członkowskie ciągu struktury NDIS_SWITCH_PORT_PARAMETERS, takie jak PortName, 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_PORT_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_PORT_ARRAY i jego tablicę NDIS_SWITCH_PORT_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ż

---

NDIS_OID_REQUEST

NDIS_SWITCH_PORT_ARRAY

NDIS_SWITCH_PORT_PARAMETERS

wykonywanie zapytań dotyczących konfiguracji przełącznika rozszerzalnego Hyper-V