FN_VMB_CLIENT_CHANNEL_INIT_SET_TARGET_PNP回呼函式 (vmbuskernelmodeclientlibapi.h)

[某些資訊與發行前發行的產品有關，在正式發行前可能會大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。]

VmbClientChannelInitSetTargetPnp 函式會依介面類型和實例標識符設定用戶端通道的目標。 如果呼叫此函式，核心模式用戶端連結庫 (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 會傳回下列值：

傳回碼	Description
STATUS_INVALID_PARAMETER_1	通道值無效或處於無效狀態，例如 Disabled。

備註

如果您有兩個虛擬網路介面，它們會有相同的 InterfaceType ，但不同的 InterfaceInstance 值。

重要

此函式是透過 VMBus 核心模式用戶端連結庫 (KMCL) 介面呼叫，由 Vmbkmcl.sys 總線驅動程式提供。 這是從 KMCL_CLIENT_INTERFACE_V1 結構存取的用戶端函式。

如需詳細資訊，請參閱 KMCL_CLIENT_INTERFACE_V1的一節。

規格需求

需求	值
最低支援的用戶端	Windows 10 (版本 1803)
標頭	vmbuskernelmodeclientlibapi.h