Nuta
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować się zalogować lub zmienić katalog.
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować zmienić katalogi.
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ż
wykonywanie zapytań dotyczących konfiguracji przełącznika rozszerzalnego Hyper-V