WPD_COMMAND_DEVICE_HINTS_GET_CONTENT_LOCATION 명령

WPD_COMMAND_DEVICE_HINTS_GET_CONTENT_LOCATION 명령은 지정된 형식의 개체를 보유할 수 있는 폴더의 개체 ID를 검색합니다. 이 명령은 무차별 개체 열거형보다 디바이스가 특정 개체를 저장하는 위치를 클라이언트에서 더 빠르게 검색할 수 있는 방법으로 제공됩니다.

명령 범주

WPD_CATEGORY_DEVICE_HINTS

매개 변수

드라이버는 다음 매개 변수를 예상합니다.

매개 변수	VarType	설명
WPD_PROPERTY_DEVICE_HINTS_CONTENT_TYPE	VT_CLSID	필수 사항입니다. 호출자가 컨테이너를 찾으려는 개체 형식입니다. 예를 들어 디지털 카메라에 이미지를 보관하는 데 사용되는 최상위 폴더를 찾기 위해 호출자는 WPD_CONTENT_TYPE_IMAGE 제출합니다. Windows 이식 가능한 디바이스에서 정의한 개체 유형 목록은 개체에 대한 요구 사항을 참조하세요.

반환 값

드라이버는 다음 결과를 반환해야 합니다.

결과	VarType	Description
WPD_PROPERTY_DEVICE_HINTS_CONTENT_LOCATIONS	VT_UNKNOWN	필수 사항입니다. 호출 매개 변수로 표시된 형식의 개체를 포함하는 폴더의 개체 ID를 지정하는 VT_LPWSTR 형식의 IPortableDevicePropVariantCollection 값입니다. 폴더를 찾을 수 없는 경우 빈 목록이어야 합니다. 결과로 표시된 폴더는 다른 콘텐츠 형식의 개체를 포함하거나 포함하지 않을 수 있습니다. 폴더 제한에 대한 자세한 내용은 WPD_FOLDER_CONTENT_TYPES_ALLOWED 속성을 참조하세요.
WPD_PROPERTY_COMMON_HRESULT	VT_ERROR	필수 사항입니다. 명령 처리의 성공 또는 실패를 나타내는 HRESULT 입니다. 호출자가 잘못된 요청을 하는 경우 드라이버는 HRESULT_FROM_WIN32(ERROR_NOT_SUPPORTED) 을 반환해야 하며 다른 결과 값을 반환할 필요가 없습니다. 오류 코드에는 Windows 이식 가능한 디바이스 오류 코드 또는 기타 적절한 오류 코드가 포함됩니다.
WPD_PROPERTY_COMMON_DRIVER_ERROR_CODE	VT_UI4	선택 사항입니다. 드라이버 관련 오류 코드입니다. 일반적으로 드라이버 테스트에만 사용되거나 드라이버, 디바이스 및 클라이언트가 모두 함께 설계된 경우에만 사용됩니다.

메서드 호출

IPortableDevice::SendCommand를 사용하여 직접 호출할 수 있습니다.

요구 사항

요구 사항	값
헤더	PortableDevice.h