次の方法で共有

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
 チャネルの の値が無効であるか、無効な状態 (Disabled など) です。

備考

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

大事な

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

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

必要条件

要件 価値
サポートされる最小クライアント Windows 10 バージョン 1803
ヘッダー vmbuskernelmodeclientlibapi.h