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