OID_SWITCH_PROPERTY_ENUM
Rozszerzenie przełącznika rozszerzalnego Hyper-V wystawia żądanie metody identyfikatora obiektu (OID) OID_SWITCH_PROPERTY_ENUM w celu uzyskania tablicy. Ta tablica zawiera aprowizowane zasady przełącznika zgodne z określonymi kryteriami. Każdy element w tablicy określa właściwości zasad rozszerzalnego przełącznika.
Element członkowski InformationBuffer struktury NDIS_OID_REQUEST zawiera wskaźnik do buforu. Ten bufor zawiera następujące dane:
Struktura NDIS_SWITCH_PROPERTY_ENUM_PARAMETERS określająca parametry wyliczenia zasad przełącznika rozszerzalnego.
Tablica struktur NDIS_SWITCH_PROPERTY_ENUM_INFO. Każda z tych struktur zawiera informacje o rozszerzalnych zasadach przełącznika.
Uwaga Jeśli rozszerzenie nie zostało zainicjowane z wystąpieniami określonych zasad rozszerzalnego przełącznika, rozszerzenie ustawia NumProperties składowej struktury NDIS_SWITCH_PROPERTY_ENUM_PARAMETERS na zero i nie są zwracane żadne struktury NDIS_SWITCH_PROPERTY_ENUM_INFO.
Uwagi
OID_SWITCH_PROPERTY_ENUM 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.
W przeciwieństwie do żądań zapytań OID OID_SWITCH_PORT_PROPERTY_ENUMrozszerzenie nie musi wywoływać żadnych ReferenceSwitchXxx ani funkcji DereferenceSwitchXxx, gdy wysyła żądanie OID_SWITCH_PROPERTY_ENUM w dół rozszerzalnego stosu sterownika przełącznika.
Uwaga Jeśli rozszerzenie odbiera żądanie metody OID OID_SWITCH_PROPERTY_ENUM, nie może ukończyć żądania OID. Zamiast tego należy wywołać NdisFOidRequest, aby przekazać żądanie OID w dół rozszerzalnego stosu sterownika przełącznika.
Kody stanu powrotu
Podstawowa krawędź miniportu przełącznika rozszerzalnego kończy żądanie zapytania OID OID_SWITCH_PROPERTY_ENUM 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ć strukturę NDIS_SWITCH_PROPERTY_ENUM_PARAMETERS i jej tablicę elementów NDIS_SWITCH_PROPERTY_ENUM_INFO. Podstawowa krawędź miniportu przełącznika rozszerzalnego ustawia DATA. METHOD_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_SWITCH_PROPERTY_ENUM_INFO
NDIS_SWITCH_PROPERTY_ENUM_PARAMETERS
wykonywanie zapytań dotyczących konfiguracji przełącznika rozszerzalnego Hyper-V