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 code | Description |
---|---|
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
Target platform |
Desktop |
Version |
Available only in Windows 7. |
Header |
Usbrpmif.h (include Usbrpmif.h) |
Library |
Usbrpm.lib |
IRQL |
PASSIVE_LEVEL |
See also