IMMDeviceCollection::Item-Methode (mmdeviceapi.h)

Die Item-Methode ruft einen Zeiger auf das angegebene Element in der Geräteauflistung ab.

Syntax

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

Parameter

[in] nDevice

Die Gerätenummer. Wenn die Sammlung n Geräte enthält, sind die Geräte 0 bis n–1 nummeriert.

[out] ppDevice

Zeiger auf eine Zeigervariable, in die die -Methode die Adresse der IMMDevice-Schnittstelle des angegebenen Elements in der Gerätesammlung schreibt. Mit dieser Methode erhält der Aufrufer einen gezählten Verweis auf die Schnittstelle. Der Aufrufer ist für das Freigeben der Schnittstelle verantwortlich, wenn sie nicht mehr benötigt wird, indem die Release-Methode der Schnittstelle aufgerufen wird. Wenn der Item-Aufruf fehlschlägt, ist *ppDeviceNULL.

Rückgabewert

Wenn die Methode erfolgreich ist, wird S_OK zurückgegeben. Wenn ein Fehler auftritt, können mögliche Rückgabecodes die in der folgenden Tabelle gezeigten Werte umfassen, sind jedoch nicht darauf beschränkt.

Rückgabecode	Beschreibung
E_POINTER	Der Parameter ppDevice ist NULL.
E_INVALIDARG	Parameter nDevice ist keine gültige Gerätenummer.

Hinweise

Diese Methode ruft einen Zeiger auf die IMMDevice-Schnittstelle des angegebenen Elements in der Gerätesammlung ab. Jedes Element in der Auflistung ist ein Endpunktobjekt, das ein Audioendpunktgerät darstellt. Der Aufrufer wählt ein Gerät aus der Gerätesammlung aus, indem er die Gerätenummer angibt. Bei einer Sammlung von n Geräten liegen die gültigen Gerätenummern zwischen 0 und n–1. Um die Anzahl der Geräte in einer Sammlung abzurufen, rufen Sie die METHODE IMMDeviceCollection::GetCount auf.

Ein Codebeispiel, das die Item-Methode aufruft, finden Sie unter Geräteeigenschaften.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	mmdeviceapi.h

Weitere Informationen

IMMDevice-Schnittstelle

IMMDeviceCollection-Schnittstelle

IMMDeviceCollection::GetCount