次の方法で共有

NdisMWriteConfigBlock 関数 (ndis.h)

  • [アーティクル]

PCI Express (PCIe) 仮想関数 (VF) のミニポート ドライバーは、VF 構成ブロックにデータを書き込むには、NdisMWriteConfigBlock 関数を呼び出します。 VF 構成ブロックに対する書き込み操作は、ネットワーク アダプターの PCIe 物理機能 (PF) のミニポート ドライバーによって処理されます。

注NdisMWriteConfigBlock は、ネットワーク アダプターの VF のミニポート ドライバーによってのみ呼び出す必要があります。
 

構文

NDIS_STATUS NdisMWriteConfigBlock(
  [in] NDIS_HANDLE NdisMiniportHandle,
  [in] ULONG       BlockId,
  [in] PVOID       Buffer,
  [in] ULONG       Length
);

パラメーター

[in] NdisMiniportHandle

ネットワーク アダプターは、NDIS がミニポートInitializeEx の ミニポートAdapterHandle パラメーターに渡ハンドルします。

[in] BlockId

書き込む構成ブロックの識別子を指定する ULONG 値。 この識別子は、独立したハードウェア ベンダー (IHV) に固有であり、ネットワーク アダプター上の PF および VF のミニポート ドライバーによってのみ使用されます。

[in] Buffer

書き込む構成データを含む呼び出し元によって割り当てられたバッファーへのポインター。

[in] Length

構成ブロックに書き込むバイト数。

戻り値

NdisMWriteConfigBlock は、次のいずれかの状態値を返すことができます。

リターン コード 形容
NDIS_STATUS_SUCCESS
 書き込み操作が正常に完了しました。
NDIS_STATUS_FAILURE
 書き込み操作に失敗しました。

備考

VF ミニポート ドライバーは、NDISMWriteConfigBlock を呼び出して、PF ミニポート ドライバーによる VF 構成データのバックチャネル書き込み要求を開始します。 この要求が通知されると、PF ドライバーは、指定された VF 構成ブロックにデータを書き込みます。

VF 構成ブロックは、PF ミニポート ドライバーと VF ミニポート ドライバー間のバックチャネル通信に使用されます。 IHV は、デバイスの 1 つ以上の VF 構成ブロックを定義できます。 各 VF 構成ブロックには、IHV で定義された形式、長さ、およびブロック ID があります。

注 各 VF 構成ブロックからのデータは、PF ミニポート ドライバーと VF ミニポート ドライバーでのみ使用されます。
 
単一ルート I/O 仮想化 (SR-IOV) インターフェイス内のバックチャネル通信の詳細については、PF/VF バックチャネル通信 SR-IOV を参照してください。

仮想バス ドライバーとのインターフェイスの

独立系ハードウェア ベンダー (IHV) が、SR-IOV ドライバー パッケージのの一部として仮想バス ドライバー (VBD) を提供する場合、ミニポート ドライバーは NdisMWriteConfigBlock 呼び出してはなりません。 代わりに、ドライバーはプライベート通信チャネルを介して VBD とインターフェイスし、VBD が WriteVfConfigBlock 呼び出すように要求する必要があります。 この関数は、基になる仮想 PCI (VPCI) バス ドライバーでサポートされている GUID_VPCI_INTERFACE_STANDARD インターフェイスから公開されます。

Hyper-V 子パーティションのゲスト オペレーティング システムで実行される VBD は、VPCI バス上の物理デバイス オブジェクト (PDO) に IRP_MN_QUERY_INTERFACE 要求を発行することで、GUID_VPCI_INTERFACE_STANDARD インターフェイスに対してクエリを実行できます。 この要求は IRQL = PASSIVE_LEVELから行う必要があります。 この要求では、ドライバーは、InterfaceType パラメーターをGUID_VPCI_INTERFACE_STANDARDに設定する必要があります。

必要条件

要件 価値
サポートされる最小クライアント サポートされていません。NDIS 6.30 以降でサポートされています。
サポートされる最小サーバー Windows Server 2012
ターゲット プラットフォーム の 万国
ヘッダー ndis.h (Ndis.h を含む)
ライブラリ Ndis.lib
IRQL <= APC_LEVEL

関連項目

GUID_VPCI_INTERFACE_STANDARD

WriteVfConfigBlock の