FN_VMB_CLIENT_CHANNEL_INIT_SET_TARGET_PNP コールバック関数 (vmbuskernelmodeclientlibapi.h)

  • [アーティクル]

[一部の情報はリリース前の製品に関することであり、正式版がリリースされるまでに大幅に変更される可能性があります。 ここに記載された情報について、Microsoft は明示または黙示を問わずいかなる保証をするものでもありません。]

VmbClientChannelInitSetTargetPnp 関数は、インターフェイスの種類とインスタンス ID によってクライアント チャネルのターゲットを設定します。 この関数が呼び出された場合、カーネル モード クライアント ライブラリ (KMCL) は PnP を使用して、提供されたインターフェイスに対応する VMBus 物理デバイス オブジェクト (PDO) を検索します。

構文

FN_VMB_CLIENT_CHANNEL_INIT_SET_TARGET_PNP FnVmbClientChannelInitSetTargetPnp;

NTSTATUS FnVmbClientChannelInitSetTargetPnp(
  VMBCHANNEL Channel,
  LPCGUID InterfaceType,
  LPCGUID InterfaceInstance,
  PFN_VMB_CHANNEL_PNP_FAILURE PnpFailureCallback
)
{...}

パラメーター

Channel

チャネルへのポインター。

InterfaceType

インターフェイス型 GUID へのポインター。 この GUID は、チャネルの種類と、チャネルで使用されるプロトコルを識別します。

InterfaceInstance

インスタンス型 GUID へのポインター。 これは、サービスの特定のインスタンスです。 指定しない場合は、指定された型を持つインスタンスが受け入れられます。

PnpFailureCallback

PnP デバイスが配置されている場合でも、デバイスが非同期的に接続に失敗した場合に呼び出すイベント コールバックへのポインター。

戻り値

VmbClientChannelInitSetTargetPnp は 、次の値を返します。

リターン コード 説明
STATUS_INVALID_PARAMETER_1
 Channel 値が無効であるか、無効な状態 (Disabled など) です。

注釈

準仮想ネットワーク インターフェイスが 2 つある場合、 InterfaceType は同じですが、 InterfaceInstance 値は異なります。

重要

この関数は、Vmbkmcl.sys バス ドライバーによって提供される VMBus カーネル モード クライアント ライブラリ (KMCL) インターフェイスを介して呼び出されます。 これは、 KMCL_CLIENT_INTERFACE_V1 構造体からアクセスされるクライアント関数です。

詳細については、 KMCL_CLIENT_INTERFACE_V1の「解説」セクションを参照してください。

要件

要件 値
サポートされている最小のクライアント Windows 10 バージョン 1803
Header vmbuskernelmodeclientlibapi.h