Udostępnij przez


OID_SRIOV_RESET_VF

Nadmierne sterowniki wystawiają żądanie zestawu identyfikatora obiektu (OID) OID_SRIOV_RESET_VF w celu zresetowania określonej funkcji wirtualnej PCI Express (PCIe) na karcie sieciowej obsługującej wirtualizację we/wy pojedynczego katalogu głównego. Nadmierne sterowniki wydają ten sterownik OID ustawiony na miniport sterownika PCI Express (PCIe) funkcji fizycznej (PF) karty sieciowej.

Element członkowski InformationBuffer struktury NDIS_OID_REQUEST zawiera wskaźnik do struktury NDIS_SRIOV_RESET_VF_PARAMETERS. Sterownik overlying określa identyfikator VF do zresetowania za pośrednictwem VFId elementu członkowskiego tej struktury.

Uwagi

VF można zresetować za pomocą resetowania poziomu funkcji PCI Express (PCIe) (FLR). Ponieważ żądanie FLR jest operacją uprzywilejowaną, można ją wykonać tylko przez sterownik miniport PF uruchamiany w systemie operacyjnym zarządzania partycji nadrzędnej Hyper-V. Nadmierne uruchamianie sterowników w systemie operacyjnym zarządzania jest powiadamiane o żądaniu FLR i wystawianiu żądania zestawu identyfikatora OID OID_SRIOV_RESET_VF sterownikowi miniportu PF.

Gdy obsługuje to żądanie OID, sterownik miniportu PF musi postępować zgodnie z następującymi wytycznymi:

  • Sterownik miniportu PF musi sprawdzić, czy VF, określony przez VFId elementu członkowskiego struktury NDIS_SRIOV_RESET_VF_PARAMETERS, ma zasoby, które zostały wcześniej przydzielone. Sterownik miniportu PF przydziela zasoby dla VF podczas żądania metody OID OID_NIC_SWITCH_ALLOCATE_VF. Jeśli zasoby dla określonego VF nie zostały przydzielone, sterownik musi zakończyć się niepowodzeniem żądania identyfikatora OID.

  • Operacja resetowania musi mieć wpływ tylko na określoną VF. Operacja nie może mieć wpływu na inne pliki VFs ani PF na tej samej karcie sieciowej.

Aby uzyskać więcej informacji, zobacz Resetowanie funkcji wirtualnej.

Kody stanu powrotu

Sterownik miniportu PF zwraca jeden z następujących kodów stanu dla ustawionego żądania OID_SRIOV_RESET_VF.

Kod stanu Opis

NDIS_STATUS_SUCCESS

Żądanie OID zostało ukończone pomyślnie.

NDIS_STATUS_NOT_SUPPORTED

Sterownik miniportu PF nie obsługuje interfejsu wirtualizacji we/wy pojedynczego katalogu głównego (SR-IOV) lub nie jest włączony do korzystania z interfejsu.

NDIS_STATUS_INVALID_PARAMETER

Co najmniej jeden z elementów członkowskich struktury NDIS_SRIOV_RESET_VF_PARAMETERS ma nieprawidłowe wartości.

NDIS_STATUS_INVALID_LENGTH

Bufor informacyjny był zbyt krótki. Sterownik miniportu PF musi ustawić DANE. SET_INFORMATION. BajtyNowe składowe w strukturze NDIS_OID_REQUEST do minimalnego wymaganego rozmiaru buforu.

NDIS_STATUS_FAILURE

Żądanie nie powiodło się z innych powodów.

Wymagania

Wersja

Obsługiwane w usłudze NDIS 6.30 i nowszych wersjach.

Nagłówek

Ntddndis.h (m.in. Ndis.h)

Zobacz też


NDIS_OID_REQUEST

NDIS_SRIOV_RESET_VF_PARAMETERS

OID_NIC_SWITCH_ALLOCATE_VF