共用方式為

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 會傳回下列值：

傳回碼 描述
STATUS_INVALID_PARAMETER_1
 信道 值無效或處於無效狀態，例如 Disabled。

言論

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

重要

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

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

要求

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