IWMDMEnumDevice::Next

The Next method returns a pointer to the next device identified by an IWMDMDevice interface.

Syntax

HRESULT Next(
  ULONG  celt,
  IWMDMDevice**  ppDevice,
  ULONG*  pceltFetched
);

Parameters

celt

[in] Number of devices requested.

ppDevice

[out] Pointer to a device identified by an instance of an IWMDMDevice interface.

pceltFetched

[out] Pointer to a variable that receives the number of devices (interfaces) returned.

Return Values

If the method succeeds, it returns S_OK. If it fails, it returns an HRESULT error code.

Return code	Description
S_FALSE	Not all the devices requested were found.
E_FAIL	An unspecified error occurred.

Remarks

Version 4.0 of the Microsoft® Windows NT® operating system cannot detect when a user physically disconnects a device. Therefore, when a device is disconnected, the Next method does not return zero in pceltFetched or NULL in ppDevice.

See Also

Previous

Next