OID_SWITCH_NIC_RESTORE

De protocolrand van de Hyper-V uitbreidbare switch geeft een OID-setaanvraag (Object Identifier) van OID_SWITCH_NIC_RESTORE op de hoogte stellen van de uitbreidbare switchextensie over runtimegegevens die kunnen worden hersteld voor een uitbreidbare switchpoort en de bijbehorende netwerkadapterverbinding.

De InformationBuffer lid van de NDIS_OID_REQUEST-structuur bevat een aanwijzer naar een NDIS_SWITCH_NIC_SAVE_STATE structuur. Deze structuur wordt toegewezen door de protocolrand van de uitbreidbare switch.

Opmerkingen

Wanneer de OID-setaanvraag van OID_SWITCH_NIC_RESTORE wordt ontvangen, moet de uitbreidbare switchextensie eerst bepalen of deze eigenaar is van de runtimegegevens. De extensie doet dit door de waarde van de ExtensionId lid van de NDIS_SWITCH_NIC_SAVE_STATE-structuur te vergelijken met de GUID-waarde die de extensie gebruikt om zichzelf te identificeren.

Als de extensie eigenaar is van de runtimegegevens voor een uitbreidbare switchpoort, worden deze gegevens op de volgende manier hersteld:

1. Met de extensie worden de runtimegegevens in de SaveData- lid gekopieerd naar aan extensie toegewezen opslag.

   Opmerking De waarde van de PortId lid van de NDIS_SWITCH_NIC_SAVE_STATE structuur kan afwijken van de PortId waarde op het moment dat de runtimegegevens zijn opgeslagen. Dit kan gebeuren als runtimegegevens zijn opgeslagen tijdens een livemigratie van de ene host naar de andere. De configuratie van de uitbreidbare switchpoort blijft echter behouden tijdens de livemigratie. Hierdoor kan de extensie de runtimegegevens herstellen naar de uitbreidbare switchpoort met behulp van de nieuwe PortId waarde.

2. De extensie voltooit de OID-setaanvraag met NDIS_STATUS_SUCCESS.

Als de extensie niet de eigenaar is van de opgegeven runtimegegevens, roept de extensie NdisFOidRequest aan om deze OID-setaanvraag door te sturen naar onderliggende extensies in de uitbreidbare switchstuurprogrammastack. In dit geval mag de extensie de NDIS_SWITCH_NIC_SAVE_STATE structuur die is gekoppeld aan de OID-aanvraag niet wijzigen.

Als de OID_SWITCH_NIC_RESTORE ingestelde aanvraag wordt ontvangen door de minipoortrand van de uitbreidbare switch, wordt de OID-aanvraag voltooid met NDIS_STATUS_SUCCESS. Hiermee wordt de protocolrand van de uitbreidbare switch aangegeven dat geen extensie eigenaar is van de runtimegegevens.

Zie Restore Hyper-V Extensible Switch Run-Time Datavoor meer informatie over het herstellen van runtimegegevens.

Opmerking Als de extensie de aanvraag voor de OID-set mislukt, mislukt de uitbreidbare switch de volledige herstelbewerking. Als gevolg hiervan moet de extensie voorkomen dat de OID-aanvraag mislukt als dit mogelijk is. Als de extensie bijvoorbeeld niet de resource kan toewijzen die nodig is om de runtimegegevens te herstellen, mislukt de OID-aanvraag als deze niet goed werkt zonder de runtimegegevens te herstellen. Als de extensie echter kan herstellen van de foutvoorwaarde, mag deze de OID-setaanvraag niet mislukken.

Statuscodes retourneren

Als de extensie de OID-setaanvraag van OID_SWITCH_NIC_RESTORE voltooit, wordt een van de volgende statuscodes geretourneerd.

Eisen

Zie ook

NDIS_OID_REQUEST

NDIS_SWITCH_NIC_SAVE_STATE

NdisFOidRequest