RPMUnloadAlternateDriverForDevice routine

The RPMUnloadAlternateDriverForDevice routine unloads the client-specified alternate driver for a device that is connected on a particular hub and connection index.

Syntax

NTSTATUS RPMUnloadAlternateDriverForDevice(
  _In_ HANDLE  RegisteredDriver,
  _In_ ULONG64 HubID,
  _In_ ULONG   ConnectionIndex
);

Parameters

  • RegisteredDriver [in]
    A handle to the registered driver to be unloaded for the device. This handle is returned by a call to the RPMRegisterAlternateDriver routine.

  • HubID [in]
    A unique identifier for the hub to which the device is connected.

  • ConnectionIndex [in]
    The connection index on which the device is connected.

Return value

Other appropriate error status values may also be returned.

Return code Description
STATUS_SUCCESS

The alternate driver has been unloaded successfully.

STATUS_UNSUCCESSFUL

The alternate driver has not been unloaded, as an invalid handle or hub ID was passed.

 

Requirements

Target platform

Desktop

Version

Available only in Windows 7.

Header

Usbrpmif.h (include Usbrpmif.h)

Library

Usbrpm.lib

IRQL

PASSIVE_LEVEL

See also

RPMRegisterAlternateDriver

RPMLoadAlternateDriverForDevice

 

 

Send comments about this topic to Microsoft