OID_SWITCH_PORT_PROPERTY_ENUM

Rozszerzenie przełącznika rozszerzalnego Hyper-V wystawia żądanie metody identyfikatora obiektu (OID) OID_SWITCH_PORT_PROPERTY_ENUM w celu uzyskania tablicy. Ta tablica zawiera aprowizowane zasady portów zgodne z określonymi kryteriami. Każdy element w tablicy określa właściwości zasad dla określonego rozszerzalnego portu 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_PORT_PROPERTY_ENUM_PARAMETERS określająca parametry wyliczania zasad określonego portu.

• Tablica struktur NDIS_SWITCH_PORT_PROPERTY_ENUM_INFO. Każda z tych struktur zawiera informacje o właściwościach rozszerzalnych zasad portów przełącznika.

  Uwaga Jeśli NumProperties składowej struktury NDIS_SWITCH_PORT_PROPERTY_ENUM_PARAMETERS jest ustawiona na zero, nie są zwracane żadne struktury NDIS_SWITCH_PORT_PROPERTY_ENUM_INFO.

Uwagi

Przed wystawieniem żądania metody OID OID_SWITCH_PORT_PROPERTY_ENUM rozszerzenie rozszerzalnego przełącznika musi postępować zgodnie z następującymi wytycznymi:

• Rozszerzenie może wystawiać żądanie OID_SWITCH_PORT_PROPERTY_ENUM tylko wtedy, gdy krawędź protokołu rozszerzalnego przełącznika wystawia żądanie OID_SWITCH_PORT_CREATE i przed wystawieniem żądania OID_SWITCH_PORT_TEARDOWN.

• Rozszerzenie musi wywołać ReferenceSwitchPort przed wywołaniem NdisFOidRequest w celu wystawienia żądania OID_SWITCH_PORT_PROPERTY_ENUM. Gwarantuje to, że określony port nie zostanie usunięty do momentu ukończenia żądania OID.

  Po zakończeniu żądania OID rozszerzenie musi wywołać DereferenceSwitchPort. Rozszerzenie musi wywołać tę funkcję niezależnie od tego, czy żądanie OID zostało ukończone z NDIS_STATUS_SUCCESS.

OID_SWITCH_PORT_PROPERTY_ENUM OID musi być wystawiany tylko wtedy, gdy przełącznik Hyper-V rozszerzalny zakończył aktywację. Aby uzyskać więcej informacji, zobacz Wykonywanie zapytań dotyczących konfiguracji przełącznika rozszerzalnego Hyper-V.

Uwaga Jeśli rozszerzenie odbiera żądanie metody OID OID_SWITCH_PORT_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_PORT_PROPERTY_ENUM i zwraca następujący kod stanu.

Wymagania

Zobacz też

DereferenceSwitchPort

NDIS_OID_REQUEST

NDIS_SWITCH_PORT_PROPERTY_ENUM_INFO

NDIS_SWITCH_PORT_PROPERTY_ENUM_PARAMETERS

NdisFOidRequest

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

ReferenceSwitchPort