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.
Nadmierny sterownik lub aplikacja trybu użytkownika wystawia żądanie metody identyfikatora obiektu (OID) OID_NIC_SWITCH_VF_PARAMETERS w celu uzyskania bieżących parametrów konfiguracji funkcji wirtualnej PCI Express (PCIe) na karcie sieciowej. Zapytania dotyczące zasobów przydzielonych za pośrednictwem żądania metody OID OID_NIC_SWITCH_ALLOCATE_VF można wykonywać tylko za pośrednictwem żądania metody OID OID_NIC_SWITCH_VF_PARAMETERS.
NDIS obsługuje żądanie metody OID OID_NIC_SWITCH_VF_PARAMETERS dla sterowników miniportu.
Po wysłaniu żądania metody OID element członkowski InformationBuffer struktury NDIS_OID_REQUEST zawiera wskaźnik do struktury NDIS_NIC_SWITCH_VF_PARAMETERS.
Uwagi
Nadmierny sterownik lub aplikacja trybu użytkownika określa VF do wykonywania zapytań przez ustawienie VFId elementu członkowskiego struktury NDIS_NIC_SWITCH_VF_PARAMETERS na identyfikator VF. Nadmierny sterownik lub aplikacja uzyskuje identyfikator VF za pomocą jednego z następujących sposobów:
Wysyłając żądanie metody OID OID_NIC_SWITCH_ENUM_VFS.
Jeśli to żądanie identyfikatora OID zostało pomyślnie ukończone, nadmierny sterownik lub aplikacja trybu użytkownika otrzyma listę wszystkich wirtualnych plików przydzielonych na karcie sieciowej. Każdy element na liście jest strukturą NDIS_NIC_SWITCH_VF_INFO z identyfikatorem VF określonym przez element członkowski VFId.
Wysyłając żądanie metody OID OID_NIC_SWITCH_ALLOCATE_VF.
Jeśli to żądanie identyfikatora OID zostało pomyślnie ukończone, sterownik nadmiernie otrzymuje identyfikator nowo utworzonego programu VF w VFId elementu członkowskiego zwróconej struktury NDIS_NIC_SWITCH_VF_PARAMETERS.
Uwaga Tylko nadmierne sterowniki mogą uzyskać identyfikator VF w ten sposób.
Po pomyślnym powrocie z żądania metody OID InformationBuffer struktury NDIS_OID_REQUEST zawiera wskaźnik do struktury NDIS_NIC_SWITCH_VF_PARAMETERS. Ta struktura zawiera parametry konfiguracji dla określonego VF.
Kody stanu powrotu
NDIS obsługuje żądanie metody OID OID_NIC_SWITCH_VF_PARAMETERS dla sterowników miniportu i zwraca następujący kod stanu dla żądań metody OID OID_NIC_SWITCH_VF_PARAMETERS.
| Kod stanu | Opis |
|---|---|
NDIS_STATUS_SUCCESS |
Żądanie zostało ukończone pomyślnie. Element członkowski InformationBuffer wskazuje strukturę NDIS_NIC_SWITCH_VF_PARAMETERS. |
NDIS_STATUS_NOT_SUPPORTED |
Sterownik miniportu 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_NIC_SWITCH_VF_PARAMETERS ma nieprawidłowe wartości. |
NDIS_STATUS_INVALID_LENGTH |
Długość buforu informacji jest mniejsza niż sizeof(NDIS_NIC_SWITCH_VF_PARAMETERS). Usługa NDIS ustawia DATA. METHOD_INFORMATION. BajtyNowe składowe w strukturze NDIS_OID_REQUEST do minimalnego wymaganego rozmiaru buforu. |
NDIS_STATUS_INVALID_LENGTH |
Bufor informacyjny był zbyt krótki. Usługa NDIS ustawia DATA. METHOD_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) |