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 |
|---|---|
|
Der Parameter ppDevice ist NULL. |
|
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 |