OID_NIC_SWITCH_VF_PARAMETERS
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) |