OID_SWITCH_NIC_RESTORE

Пограничный протокол расширяемого коммутатора Hyper-V выдает запрос набора идентификаторов объектов (OID) OID_SWITCH_NIC_RESTORE для уведомления расширения расширяемого коммутатора о данных во время выполнения, которые можно восстановить для расширяемого порта коммутатора и подключения к сетевому адаптеру.

Элемент InformationBuffer структуры NDIS_OID_REQUEST содержит указатель на структуру NDIS_SWITCH_NIC_SAVE_STATE. Эта структура выделяется краем протокола расширяемого коммутатора.

Замечания

Когда он получает запрос набора OID OID_SWITCH_NIC_RESTORE, расширение расширяемого коммутатора должно сначала определить, принадлежит ли он данным во время выполнения. Это расширение выполняется путем сравнения значения ExtensionId члена структуры NDIS_SWITCH_NIC_SAVE_STATE со значением GUID, которое используется расширением для идентификации себя.

Если расширение владеет данными времени выполнения для расширяемого порта коммутатора, оно восстанавливает эти данные следующим образом:

1. Расширение копирует данные во время выполнения в элемент SaveData в хранилище, выделенное расширением.

   Примечание Значение PortId структуры NDIS_SWITCH_NIC_SAVE_STATE может отличаться от значения PortId во время сохранения данных во время выполнения. Это может произойти, если данные во время выполнения были сохранены во время динамической миграции с одного узла на другой. Однако конфигурация расширяемого порта коммутатора сохраняется во время динамической миграции. Это позволяет расширению восстановить данные во время выполнения на расширяемый порт коммутатора с помощью нового значения PortId.

2. Расширение завершает запрос набора OID с NDIS_STATUS_SUCCESS.

Если расширение не владеет указанными данными времени выполнения, расширение вызывает NdisFOidRequest для пересылки этого запроса набора OID в базовые расширения в стеке расширяемого драйвера коммутатора. В этом случае расширение не должно изменять структуру NDIS_SWITCH_NIC_SAVE_STATE, связанную с запросом OID.

Если запрос OID_SWITCH_NIC_RESTORE набора получается мини-портом расширяемого коммутатора, он завершает запрос OID с NDIS_STATUS_SUCCESS. Это уведомляет пограничный протокол расширяемого коммутатора о том, что расширение не владеет данными во время выполнения.

Дополнительные сведения о том, как восстановить данные во время выполнения, см. в разделе Восстановление Hyper-V расширяемого коммутатора Run-Time данных.

Примечание Если расширение завершается сбоем запроса набора OID, расширяемый коммутатор завершится сбоем всей операции восстановления. В результате расширение должно избежать сбоя запроса OID, если это возможно. Например, если расширение не может выделить ресурс, необходимый для восстановления данных во время выполнения, он должен завершить запрос OID, если он не может работать должным образом, не восстанавливая данные во время выполнения. Однако если расширение может восстановиться после условия сбоя, оно не должно завершать запрос набора OID.

Коды состояния возврата

Если расширение завершает запрос набора OID OID_SWITCH_NIC_RESTORE, он возвращает один из следующих кодов состояния.

Требования

См. также

NDIS_OID_REQUEST

NDIS_SWITCH_NIC_SAVE_STATE

NdisFOidRequest