SRIOV_QUERY_VF_LUID コールバック関数 (pcivirt.h)

PCI Express SR-IOV 仮想関数 (VF) のローカル一意識別子を取得します。

構文

SRIOV_QUERY_VF_LUID SriovQueryVfLuid;

NTSTATUS SriovQueryVfLuid(
  [in]  PVOID Context,
  [in]  USHORT VfIndex,
  [out] PLUID Luid
)
{...}

パラメーター

[in] Context

ドライバー定義コンテキストへのポインター。

[in] VfIndex

クエリ対象の VF の 0 から始まるインデックス。

[out] Luid

インターフェイスを実装するSR_IOV デバイスのローカル一意識別子へのポインター。

戻り値

操作が成功した場合は、STATUS_SUCCESSを返します。 それ以外の場合は、適切な NTSTATUS エラー コードを返します。

注釈

このコールバック関数は、物理関数 (PF) ドライバーによって実装されます。 システムが特定の仮想関数の識別子を取得する場合に呼び出されます。

PF ドライバーは、SRIOV_DEVICE_INTERFACE_STANDARD_2の QueryLuid メンバーを設定し、 WDF_QUERY_INTERFACE_CONFIG 構造体を構成し、 WdfDeviceAddQueryInterface を呼び出すことによって、その実装を登録します。

このコールバック関数の実装例を次に示します。 PF ドライバーは、 ZwAllocateLocallyUniqueId を呼び出して一意の識別子を生成し、デバイス コンテキストに格納します。

NTSTATUS
Virtualization_QueryLuid (
    _In_        PVOID             Context,
    _Out_       PLUID             Luid
    )
{
    PDEVICE_CONTEXT deviceContext;

    PAGED_CODE();

    deviceContext = (PDEVICE_CONTEXT)Context;
    *Luid = deviceContext->Luid;

    return STATUS_SUCCESS;
}

要件