WDC_PciSriovEnable()

DWORD DLLCALLCONV WDC_PciSriovEnable	(	_In_ WDC_DEVICE_HANDLE	hDev,
		_In_ DWORD	dwNumVFs
	)

SR-IOV API functions are not part of the standard WinDriver API, and not included in the standard version of WinDriver.

---

Control device's SR-IOV capability (PCIe)

"WinDriver for Server" API and require "WinDriver for Server" license. Note that "WinDriver for Server" APIs are included in WinDriver evaluation version. Enables SR-IOV for a supported device.

Parameters

[in]	hDev	Handle to a Plug-and-Play WDC device, returned by WDC_PciDeviceOpen()
[in]	dwNumVFs	The number of virtual functions (VFs) to be assigned to hDev

Returns

Returns WD_STATUS_SUCCESS (0) on success, or an appropriate error code otherwise

 
 
void SriovExample(WDC_DEVICE_HANDLE hDev)
{
    DWORD dwStatus, dwNumVFs = 3;
 
    dwStatus = WDC_PciSriovEnable(hDev, dwNumVFs);
    if (dwStatus)
    {
        printf("Error! Could not enable SRIOV\n");
        return;
    }
 
    dwNumVFs = 0;
    dwStatus = WDC_PciSriovGetNumVFs(hDev, &dwNumVFs);
    if (dwStatus)
    {
        printf("Error! Could not get number of virtual functions\n");
        goto Error;
    }
 
    // Should be 3
    printf("Number of virtual functions: %ld\n", dwNumVFs);
 
    /*
        More code...
    */
 
Error:
    dwStatus = WDC_PciSriovDisable(hDev);
    if (dwStatus)
    {
        printf("Error! Could not disable SRIOV\n");
    }
}