Zarządzanie informacjami o stanie funkcji przełącznika niestandardowego

Interfejs przełącznika rozszerzalnego Hyper-V używa następującego identyfikatora obiektu (OID) do wykonywania zapytań o informacje o stanie niestandardowym dla rozszerzalnego przełącznika. Te informacje o stanie są znane jako informacje o stanie funkcji przełącznika:

Zapytanie o status funkcji przełącznika
To żądanie metody OID jest wystawiane przez krawędź protokołu rozszerzenia przełącznika w celu uzyskania niestandardowych informacji o stanie funkcji dla określonej właściwości przełącznika.

Po pomyślnym zakończeniu żądania metody OID, członek InformationBuffer struktury NDIS_OID_REQUEST zawiera wskaźnik do buforu. Ten bufor zawiera następujące dane:

• Struktura NDIS_SWITCH_FEATURE_STATUS_PARAMETERS określająca informacje o stanie funkcji niestandardowej, które mają być zwracane.

  Uwaga Aby uzyskać stan funkcji niestandardowej, element członkowski FeatureStatusType jest ustawiony na NdisSwitchPropertyTypeCustom.

• Struktura NDIS_SWITCH_FEATURE_STATUS_CUSTOM zawierająca informacje o stanie właściwości niestandardowej przypisanej do rozszerzalnego portu przełącznika.

  Gdy krawędź protokołu przełącznika rozszerzalnego wydaje żądanie OID_SWITCH_FEATURE_STATUS_QUERY, ustawia członków FeatureStatusCustomBufferLength i FeatureStatusCustomBufferOffset w lokalizacji w członku InformationBuffer, za pomocą którego rozszerzenie może zwrócić informacje o stanie funkcji.

Moduł rozszerzalnego przełącznika powinien spełniać te wytyczne, gdy otrzymuje żądanie metody OID OID_SWITCH_FEATURE_STATUS_QUERY:

• Rozszerzenie musi obsługiwać żądanie OID, jeśli zarządza stanem rozszerzalnej funkcji przełącznika, który odpowiada FeatureStatusId członu struktury NDIS_SWITCH_FEATURE_STATUS_PARAMETERS.

• Jeśli rozszerzenie obsługuje żądanie metody OID, musi zwrócić informacje o stanie funkcji zgodne z parametrami określonymi przez strukturę NDIS_SWITCH_FEATURE_STATUS_PARAMETERS.

  Jeśli bufor stanu funkcji jest za mały, rozszerzenie musi odrzucić żądanie OID ze statusem NDIS_STATUS_INVALID_LENGTH. Rozszerzenie musi ustawić DATA.SET_INFORMATION.BytesNeeded człon w strukturze NDIS_OID_REQUEST na minimalny wymagany rozmiar buforu.

  W przeciwnym razie rozszerzenie musi zwrócić informacje o stanie funkcji i zakończyć żądanie OID z NDIS_STATUS_SUCCESS.

• Jeśli rozszerzenie nie zarządza stanem funkcji niestandardowego przełącznika rozszerzalnego, musi wywołać NdisFOidRequest, aby przekazać żądanie OID w dół stosu sterownika przełącznika rozszerzalnego.

  Aby uzyskać więcej informacji na temat przekazywania żądań OID, zobacz Filtrowanie żądań OID w sterowniku filtru NDIS.

Aby uzyskać więcej informacji o sposobie definiowania i rejestrowania informacji o stanie funkcji przełącznika, zobacz Stan funkcji przełącznika niestandardowego.