共用方式為

IMMDeviceCollection：：Item 方法 (mmdeviceapi.h)

  • 發行項

Item 方法會擷取裝置集合中指定專案的指標。

語法

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

參數

[in] nDevice

裝置號碼。 如果集合包含 n 個裝置，則裝置編號為 0 到 n– 1。

[out] ppDevice

指標變數的指標，方法會在其中寫入裝置集合中指定專案的 IMMDevice 介面位址。 透過這個方法，呼叫端會取得介面的計數參考。 呼叫端負責藉由呼叫介面的 Release 方法，在不再需要介面時釋出介面。 如果 Item 呼叫失敗， *ppDevice 為 NULL。

傳回值

如果方法成功，它會傳回 S_OK。 如果失敗，可能的傳回碼包括，但不限於下表所示的值。

傳回碼 Description
E_POINTER
 參數 ppDevice 為 NULL。
E_INVALIDARG
 參數 nDevice 不是有效的裝置號碼。

備註

這個方法會擷取裝置集合中指定專案的 IMMDevice 介面指標。 集合中的每個專案都是代表音訊端點裝置的端點物件。 呼叫端會藉由指定裝置號碼，從裝置集合中選取裝置。 針對 n 個裝置的集合，有效的裝置號碼範圍從 0 到 n– 1。 若要取得集合中的裝置計數，請呼叫 IMMDeviceCollection：：GetCount 方法。

如需呼叫 Item 方法的程式代碼範例，請參閱 裝置屬性。

規格需求

需求 值
最低支援的用戶端 Windows Vista [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2008 [僅限傳統型應用程式]
目標平台 Windows
標頭 mmdeviceapi.h

另請參閱

IMMDevice 介面

IMMDeviceCollection 介面

IMMDeviceCollection：：GetCount