IPnpCallbackRemoteInterfaceNotification::OnRemoteInterfaceArrival method (wudfddi.h)

[Warning: UMDF 2 is the latest version of UMDF and supersedes UMDF 1. All new UMDF drivers should be written using UMDF 2. No new features are being added to UMDF 1 and there is limited support for UMDF 1 on newer versions of Windows 10. Universal Windows drivers must use UMDF 2. For more info, see Getting Started with UMDF.]

A driver's OnRemoteInterfaceArrival event callback function informs the driver when a device interface is available.

Syntax

void OnRemoteInterfaceArrival(
  [in] IWDFRemoteInterfaceInitialize *pWdfRemoteInterfaceInit
);

Parameters

[in] pWdfRemoteInterfaceInit

A pointer to the IWDFRemoteInterfaceInitialize interface that identifies the device interface that has arrived.

Return value

None

Remarks

A UMDF-based driver can register its optional OnRemoteInterfaceArrival event callback function by calling IWDFDevice2::RegisterRemoteInterfaceNotification.

The driver can use methods of the IWDFRemoteInterfaceInitialize interface to determine which device interface has arrived.

Before the driver can send I/O requests to the device interface, the driver must do the following:

  1. Call IWDFDevice2::CreateRemoteInterface to create a remote interface object.
  2. Call IWDFDevice2::CreateRemoteTarget to create a remote target object.
  3. Call IWDFRemoteTarget::OpenRemoteInterface to connect the interface object to the remote target object and open the remote target for I/O operations.
For more information about using remote interface objects to access device interfaces, see Using Device Interfaces in UMDF-based Drivers

Requirements

Requirement Value
End of support Unavailable in UMDF 2.0 and later.
Target Platform Desktop
Minimum UMDF version 1.9
Header wudfddi.h (include Wudfddi.h)

See also

IPnpCallbackRemoteInterfaceNotification

IWDFDevice2::CreateRemoteInterface

IWDFDevice2::CreateRemoteTarget

IWDFRemoteInterfaceInitialize

IWDFRemoteTarget::OpenRemoteInterface