IPnpCallbackRemoteInterfaceNotification::OnRemoteInterfaceArrival method

[Applies to UMDF 1.x only]

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

Syntax


void OnRemoteInterfaceArrival(
  [in]  IWDFRemoteInterfaceInitialize *pWdfRemoteInterfaceInit
);

Parameters

pWdfRemoteInterfaceInit [in]

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

End of support

Unavailable in UMDF 2.0 and later.

Minimum UMDF version

1.9

Header

Wudfddi.h (include Wudfddi.h)

See also

IPnpCallbackRemoteInterfaceNotification
IWDFDevice2::CreateRemoteInterface
IWDFDevice2::CreateRemoteTarget
IWDFRemoteTarget::OpenRemoteInterface
IWDFRemoteInterfaceInitialize

 

 

Send comments about this topic to Microsoft

Show:
© 2014 Microsoft