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.
Krawędź protokołu Hyper-V rozszerzalnego przełącznika wystawia żądanie ustawienia identyfikatora obiektu (OID) OID_SWITCH_PROPERTY_UPDATE w celu powiadamiania rozszerzalnych rozszerzeń przełącznika o aktualizacji parametrów dla rozszerzalnej właściwości zasad 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_PARAMETERS określająca identyfikację i typ zasad rozszerzalnego przełącznika.
Bufor właściwości zawierający parametry zasad rozszerzalnego przełącznika. Bufor właściwości zawiera strukturę opartą na PropertyType składowej struktury NDIS_SWITCH_PROPERTY_PARAMETERS.
uwaga Począwszy od systemu Windows Server 2012, element członkowski PropertyType musi być ustawiony na NdisSwitchPropertyTypeCustom, a bufor właściwości musi zawierać strukturę NDIS_SWITCH_PROPERTY_CUSTOM.
Uwagi
Rozszerzenie przekazujące może obsługiwać żądanie zestawu identyfikatorów OID OID_SWITCH_PROPERTY_UPDATE. Wszystkie inne typy rozszerzeń muszą wywoływać NdisFOidRequest, aby przekazać żądanie OID do następnego rozszerzenia w rozszerzalnym stosie sterowników przełącznika.
Rozszerzenie może zawetować aktualizację właściwości przełącznika, zwracając NDIS_STATUS_DATA_NOT_ACCEPTED dla żądania OID. Jeśli na przykład rozszerzenie nie może przydzielić zasobów w celu wymuszenia zaktualizowanych zasad na przełączniku, powinno zawetować żądanie aktualizacji.
Uwaga Jeśli rozszerzenie zwraca inne kody stanu błędów NDIS_STATUS_Xxx, powiadomienie o utworzeniu jest również weto. Jednak zwracanie kodów stanu dla scenariuszy przejściowych, takich jak zwracanie NDIS_STATUS_RESOURCES, może spowodować ponowienie próby powiadomienia o utworzeniu.
Jeśli rozszerzenie nie zawetuje żądania OID, powinno monitorować stan po zakończeniu żądania. Rozszerzenie powinno to zrobić, aby określić, czy żądanie OID zostało zawetowane przez podstawowe rozszerzenia w rozszerzalnej ścieżce sterowania przełącznika, czy przez rozszerzalny interfejs przełącznika.
Aby uzyskać wskazówki dotyczące obsługi żądania zestawu identyfikatorów OID OID_SWITCH_PROPERTY_UPDATE, zobacz Zarządzanie zasadami przełącznika.
Kody stanu powrotu
Jeśli rozszerzenie ukończy żądanie zestawu identyfikatorów OID OID_SWITCH_PROPERTY_UPDATE, zwraca jeden z następujących kodów stanu.
| Kod stanu | Opis |
|---|---|
NDIS_STATUS_DATA_NOT_ACCEPTED |
Rozszerzenie zawetował powiadomienie o aktualizacji zasad przełącznika. |
NDIS_STATUS_FAILURE |
Żądanie identyfikatora OID nie powiodło się z innych powodów. |
Jeśli rozszerzenie nie ukończy żądania zestawu identyfikatorów OID OID_SWITCH_PROPERTY_UPDATE, żądanie jest wykonywane przez podstawową krawędź miniportu przełącznika rozszerzalnego. Krawędź miniportu zwraca następujący kod stanu.
| Kod stanu | Opis |
|---|---|
NDIS_STATUS_SUCCESS |
Żądanie OID zostało ukończone pomyślnie. |
Wymagania
Wersja |
Obsługiwane w usłudze NDIS 6.30 i nowszych wersjach. |
Nagłówek |
Ntddndis.h (m.in. Ndis.h) |