Expand Minimize

RPMGetAvailableDevices routine

The RPMGetAvailableDevices routine returns a list of the attached USB devices (except hubs and HIDs).

Syntax


NTSTATUS RPMGetAvailableDevices(
  _In_   HANDLE RegisteredDriver,
  _In_   USHORT Locale,
  _Out_  PUSBRPM_DEVICE_LIST *DeviceList
);

Parameters

RegisteredDriver [in]

A handle to a registered driver. This handle is returned by a call to the RPMRegisterAlternateDriver routine.

Locale [in]

The locale identifier in which the device manufacturer string and product string is returned. If the device does not support the locale, the library defaults to en-US (0409).

DeviceList [out]

A list of USB devices that are attached to the host.

Return value

Return codeDescription
STATUS_SUCCESS

The registered driver is valid.

STATUS_UNSUCCESSFUL

The registered driver is invalid.

STATUS_INSUFFICIENT_RESOURCES

There is insufficient memory available to complete the call.

 

Remarks

The caller of this routine is required to free this memory, which is allocated from paged pool.

Requirements

Version

Available only in Windows 7.

Header

Usbrpmif.h (include Usbrpmif.h)

Library

Contained in usbrpm.lib. Link with usbrpm.lib.

IRQL

PASSIVE_LEVEL

See also

RPMRegisterAlternateDriver
USB Device Redirection Routines

 

 

Send comments about this topic to Microsoft

Build date: 12/5/2013

Show:
© 2014 Microsoft. All rights reserved.