IPortableDevicePropertiesBulk：：QueueGetValuesByObjectFormat 方法 (portabledeviceapi.h)
QueueGetValuesByObjectFormat 介面會將裝置上特定格式對象的屬性要求排入佇列。
語法
HRESULT QueueGetValuesByObjectFormat(
[in] REFGUID pguidObjectFormat,
[in] LPCWSTR pszParentObjectID,
[in] const DWORD dwDepth,
[in] IPortableDeviceKeyCollection *pKeys,
[in] IPortableDevicePropertiesBulkCallback *pCallback,
[out] GUID *pContext
);
參數
[in] pguidObjectFormat
指定物件格式之 GUID 的指標。 只會查詢此類型的物件。
[in] pszParentObjectID
Null 終止字串的指標，其中包含應該開始搜尋之父物件的物件標識符。 若要搜尋裝置上的所有物件，請指定 WPD_DEVICE_OBJECT_ID。
[in] dwDepth
在父代下方搜尋的最大深度，其中 1 表示僅限立即子系。 這個數位可接受大於實際層級數目。 若要搜尋任何深度，請指定0xFFFFFFFF
[in] pKeys
IPortableDeviceKeyCollection 介面的指標，其中包含要擷取的屬性。 如需 Windows 可攜式裝置所定義的屬性清單，請參閱 屬性和屬性。 指定 NULL 以指出來自指定格式的所有屬性。
[in] pCallback
應用程式實作 IPortableDevicePropertiesBulkCallback 介面的指標，它會在擷取資訊時接收資訊。
[out] pContext
將用來啟動、取消或識別 IPortableDevicePropertiesBulkCallback 回呼中之 GUID 的指標，如果實作的話。
傳回值
方法會傳回 HRESULT。 可能的值包括 (但不限於) 下表中的這些值。
| 傳回碼 | 描述 |
|---|---|
|
作業已成功排入佇列。 |
備註
如果您為 pguidObjectFormat 參數指定WPD_OBJECT_FORMAT_ALL，這個方法會傳回裝置上所有物件的屬性。
如果 pszParentObjectID 參數設定為空字串 (“”“) ，此方法將會執行相依 於 dwDepth 參數的搜尋，如下表所述。
| dwDepth | 方法傳回 |
| 0 | 無任何結果 |
| 1 | 僅限指定裝置的值。 |
| 2 | 指定裝置的值，以及在該裝置上找到的所有功能物件。 |
如果 pszParentObjectID 參數設定為 WPD_DEVICE_OBJECT_ID，此方法會執行相依於 dwDepth 參數的搜尋，如下表所述。
| dwDepth | 方法傳回 |
| 0 | 僅限指定裝置的值。 |
| 1 | 指定裝置的值，以及在該裝置上找到的所有功能物件。 |
在應用程式呼叫 Start 之前，不會啟動佇列要求。 如需如何使用此方法的詳細資訊，請參閱 IPortableDevicePropertiesBulk 介面。
由於效能問題，某些裝置在 pKeys 參數為 NULL 時可能不會傳回完整的屬性清單。
規格需求
| 需求 | 值 |
|---|---|
| 目標平台 | Windows |
| 標頭 | portabledeviceapi.h |
| 程式庫 | PortableDeviceGUIDs.lib |