Notitie
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen u aan te melden of de directory te wijzigen.
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen de mappen te wijzigen.
Een overliggend stuurprogramma of toepassing in de gebruikersmodus geeft een OID-methodeaanvraag (Object Identifier) van OID_NIC_SWITCH_VF_PARAMETERS op om de huidige configuratieparameters van een PCI Express (PCIe) Virtual Function (VF) op een netwerkadapter te verkrijgen. Alleen VFs waaraan resources zijn toegewezen via een OID-methodeaanvraag van OID_NIC_SWITCH_ALLOCATE_VF kunnen worden opgevraagd via een OID-methodeaanvraag van OID_NIC_SWITCH_VF_PARAMETERS.
NDIS verwerkt de OID-methodeaanvraag van OID_NIC_SWITCH_VF_PARAMETERS voor minipoortstuurprogramma's.
Wanneer de OID-methodeaanvraag wordt ingediend, bevat de InformationBuffer lid van de NDIS_OID_REQUEST-structuur een aanwijzer naar een NDIS_NIC_SWITCH_VF_PARAMETERS-structuur.
Opmerkingen
De toepassing voor het overliggende stuurprogramma of de gebruikersmodus geeft de VF op die moet worden opgeslagen door de VFId in te stellen lid van de NDIS_NIC_SWITCH_VF_PARAMETERS structuur op de id van de VF. Het overliggende stuurprogramma of de toepassing verkrijgt de VF-id op een van de volgende manieren:
Door een OID-methodeaanvraag van OID_NIC_SWITCH_ENUM_VFSuit te geven.
Als deze OID-aanvraag is voltooid, ontvangt de toepassing voor het overliggende stuurprogramma of de gebruikersmodus een lijst met alle VFs die zijn toegewezen aan de netwerkadapter. Elk element in de lijst is een NDIS_NIC_SWITCH_VF_INFO structuur, waarbij de VF-id is opgegeven door de VFId lid.
Door een OID-methodeaanvraag van OID_NIC_SWITCH_ALLOCATE_VFuit te geven.
Als deze OID-aanvraag is voltooid, ontvangt het overliggende stuurprogramma de id van de zojuist gemaakte VF in de VFId lid van de geretourneerde NDIS_NIC_SWITCH_VF_PARAMETERS structuur.
Opmerking Alleen overliggende stuurprogramma's kunnen de VF-id op deze manier verkrijgen.
Nadat de OID-methodeaanvraag is geretourneerd, bevat de InformationBuffer lid van de NDIS_OID_REQUEST-structuur een aanwijzer naar een NDIS_NIC_SWITCH_VF_PARAMETERS structuur. Deze structuur bevat de configuratieparameters voor de opgegeven VF.
Statuscodes retourneren
NDIS verwerkt de OID-methodeaanvraag van OID_NIC_SWITCH_VF_PARAMETERS voor minipoortstuurprogramma's en retourneert de volgende statuscode voor OID-methodeaanvragen van OID_NIC_SWITCH_VF_PARAMETERS.
| Statuscode | Beschrijving |
|---|---|
NDIS_STATUS_SUCCESS |
De aanvraag is voltooid. De InformationBuffer lid verwijst naar een NDIS_NIC_SWITCH_VF_PARAMETERS structuur. |
NDIS_STATUS_NOT_SUPPORTED |
Het minipoortstuurprogramma biedt geen ondersteuning voor de I/O-interface met één hoofdmap (SR-IOV) of is niet ingeschakeld voor het gebruik van de interface. |
NDIS_STATUS_INVALID_PARAMETER |
Een of meer leden van de NDIS_NIC_SWITCH_VF_PARAMETERS structuur hebben ongeldige waarden. |
NDIS_STATUS_INVALID_LENGTH |
De lengte van de informatiebuffer is kleiner dan de grootte (NDIS_NIC_SWITCH_VF_PARAMETERS). NDIS stelt de DATA in. METHOD_INFORMATION. BytesNeeded lid in de NDIS_OID_REQUEST structuur tot de minimale buffergrootte die is vereist. |
NDIS_STATUS_INVALID_LENGTH |
De informatiebuffer was te kort. NDIS stelt de DATA in. METHOD_INFORMATION. BytesNeeded lid in de NDIS_OID_REQUEST structuur tot de minimale buffergrootte die is vereist. |
NDIS_STATUS_FAILURE |
De aanvraag is om andere redenen mislukt. |
Eisen
Versie |
Ondersteund in NDIS 6.30 en hoger. |
Rubriek |
Ntddndis.h (inclusief Ndis.h) |