IPnpCallbackRemoteInterfaceNotification::OnRemoteInterfaceArrival method (wudfddi.h)

Article
02/22/2024

[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:

Call IWDFDevice2::CreateRemoteInterface to create a remote interface object.
Call IWDFDevice2::CreateRemoteTarget to create a remote target object.
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)