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
검색을 시작해야 하는 부모 개체의 개체 ID를 포함하는 null로 끝나는 문자열에 대한 포인터입니다. 디바이스의 모든 개체를 검색하려면 WPD_DEVICE_OBJECT_ID 지정합니다.
[in] dwDepth
부모 아래에서 검색할 최대 깊이입니다. 여기서 1은 직계 자식만을 의미합니다. 이 숫자가 실제 수준 수보다 클 수 있습니다. 깊이를 검색하려면 0xFFFFFFFF 지정합니다.
[in] pKeys
검색할 속성이 포함된 IPortableDeviceKeyCollection 인터페이스에 대한 포인터입니다. Windows 이식 가능한 디바이스에서 정의한 속성 목록은 속성 및 특성을 참조하세요. 지정된 형식의 모든 속성을 나타내려면 NULL 을 지정합니다.
[in] pCallback
검색될 때 정보를 수신하는 애플리케이션 구현 IPortableDevicePropertiesBulkCallback 인터페이스에 대한 포인터입니다.
[out] pContext
구현된 경우 IPortableDevicePropertiesBulkCallback 콜백 에서 요청을 시작, 취소 또는 식별하는 데 사용되는 GUID에 대한 포인터입니다.
반환 값
이 메서드는 HRESULT를 반환합니다. 가능한 값에는 다음 표에 있는 값이 포함되지만, 이에 국한되는 것은 아닙니다.
| 반환 코드 | Description |
|---|---|
|
작업이 성공적으로 큐에 대기되었습니다. |
설명
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 |