Windows Dev Center

IMMDeviceCollection::Item method

The Item method retrieves a pointer to the specified item in the device collection.

Syntax


HRESULT Item(
  [in]  UINT      nDevice,
  [out] IMMDevice **ppDevice
);

Parameters

nDevice [in]

The device number. If the collection contains n devices, the devices are numbered 0 to n– 1.

ppDevice [out]

Pointer to a pointer variable into which the method writes the address of the IMMDevice interface of the specified item in the device collection. Through this method, the caller obtains a counted reference to the interface. The caller is responsible for releasing the interface, when it is no longer needed, by calling the interface's Release method. If the Item call fails, *ppDevice is NULL.

Return value

If the method succeeds, it returns S_OK. If it fails, possible return codes include, but are not limited to, the values shown in the following table.

Return codeDescription
E_POINTER

Parameter ppDevice is NULL.

E_INVALIDARG

Parameter nDevice is not a valid device number.

 

Remarks

This method retrieves a pointer to the IMMDevice interface of the specified item in the device collection. Each item in the collection is an endpoint object that represents an audio endpoint device. The caller selects a device from the device collection by specifying the device number. For a collection of n devices, valid device numbers range from 0 to n– 1. To obtain a count of the devices in a collection, call the IMMDeviceCollection::GetCount method.

For a code example that calls the Item method, see Device Properties.

Requirements

Minimum supported client

Windows Vista [desktop apps only]

Minimum supported server

Windows Server 2008 [desktop apps only]

Header

Mmdeviceapi.h

See also

IMMDevice Interface
IMMDeviceCollection Interface
IMMDeviceCollection::GetCount

 

 

Community Additions

ADD
Show:
© 2015 Microsoft