FN_VMB_CLIENT_CHANNEL_INIT_SET_TARGET_PNP 콜백 함수(vmbuskernelmodeclientlibapi.h)

[일부 정보는 상업용으로 출시되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 명시적 또는 묵시적 보증을 하지 않습니다.]

VmbClientChannelInitSetTargetPnp 함수는 인터페이스 유형 및 instance 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

instance 형식 GUID에 대한 포인터입니다. 이는 서비스의 특정 instance. 제공되지 않으면 제공된 형식의 모든 instance 허용됩니다.

PnpFailureCallback

PnP 디바이스가 있는 경우에도 디바이스가 비동기적으로 연결되지 않는 경우 호출할 이벤트 콜백에 대한 포인터입니다.

반환 값

VmbClientChannelInitSetTargetPnp 는 다음 값을 반환합니다.

반환 코드	설명
STATUS_INVALID_PARAMETER_1	채널 값이 잘못되었거나 사용 안 함과 같은 잘못된 상태입니다.

설명

두 개의 반가상 네트워크 인터페이스가 있는 경우 InterfaceType 은 동일하지만 InterfaceInstance 값은 다릅니다.

중요

이 함수는 Vmbkmcl.sys 버스 드라이버에서 제공하는 KMCL(VMBus 커널 모드 클라이언트 라이브러리) 인터페이스를 통해 호출됩니다. KMCL_CLIENT_INTERFACE_V1 구조에서 액세스하는 클라이언트 함수입니다.

자세한 내용은 KMCL_CLIENT_INTERFACE_V1 설명 섹션을 참조 하세요.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 10, 버전 1803
머리글	vmbuskernelmodeclientlibapi.h