IOCTL_SRIOV_PROXY_QUERY_LUID IOCTL (pcivirt.h)

Article
05/18/2021

This request supplies the local unique identifier of the SR_IOV device implementing the interface.

Major code

IRP_MJ_DEVICE_CONTROL

Output buffer

A pointer to a SRIOV_PROXY_QUERY_LUID_OUTPUT structure that is filled with the identifier.

Output buffer length

The size of the SRIOV_PROXY_QUERY_LUID_OUTPUT structure

Status block

Irp->IoStatus.Status is set to STATUS_SUCCESS if the request is successful. Otherwise, Status to the appropriate error condition as a NTSTATUS code.

Remarks

This IOCTL request is sent by the virtualization stack to the PCI Express SR-IOV Physical Function (PF) driver that exposes GUID_DEVINTERFACE_VIRTUALIZABLE_DEVICE.

This IOCTL request originates in the user mode and is handled by the physical function (PF) driver in order to supply the local unique identifier of the physical device. This request is only required for SR-IOV devices doing direct assignment.

Before sending this request, the user mode application must obtain a handle to the PCI Express SR-IOV device by querying for GUID_DEVINTERFACE_VIRTUALIZABLE_DEVICE.

In this example, the PF driver generates a unique identifier by calling ZwAllocateLocallyUniqueId and stores it in the device context.



    case IOCTL_SRIOV_PROXY_QUERY_LUID:

        status = WdfRequestRetrieveOutputBuffer(Request,
                                                sizeof(LUID),
                                                &luid,
                                                NULL);
        if (!NT_SUCCESS(status))
        {
            break;
        }

        RtlCopyMemory(luid, &deviceContext->Luid, sizeof(LUID));
        WdfRequestSetInformation(Request, sizeof(LUID));
        status = STATUS_SUCCESS;
        break;

Requirements

Requirement	Value
Header	pcivirt.h
IRQL	PASSIVE_LEVEL

Share via