명령(WPD API)

  • 아티클

클라이언트 애플리케이션과 드라이버는 클라이언트에서(Windows 이식 가능한 디바이스 API를 통해) 드라이버로 전송되는 명령을 통해(User-Mode 드라이버 프레임워크를 통해) 통신합니다. 명령은 매개 변수를 포함하거나 포함하지 않을 수 있으며 결과를 반환할 수도 있고 반환하지 않을 수도 있습니다. 클라이언트는 IPortableDevice::SendCommand 메서드 또는 IPortableDeviceService:SendCommand 메서드를 호출하거나 암시적으로 클라이언트 인터페이스의 메서드를 호출하여 명령을 명시적으로 보낼 수 있습니다. 몇 가지 명령은 명시적으로만 보낼 수 있습니다. 이러한 항목은 명령의 설명서에 나와 있습니다. 명령 참조 페이지에서는 명령의 목적과 수신할 것으로 예상되는 매개 변수 및 반환할 매개 변수를 설명합니다.

명령은 PROPERTYKEY 구조체로 식별됩니다. GUID 파트( fmtid 멤버)와 DWORD 파트( pid 멤버)의 두 부분으로 구성됩니다. GUID 부분은 명령이 속한 범주를 나타내는 데 사용됩니다(관련 명령은 동일한 범주에 속하므로 fmtid가 같음). DWORD 부분은 명령 ID를 나타내며 명령 범주 내의 개별 명령을 구분하는 데 사용됩니다(동일한 범주의 명령에 대한 pid 값은 다릅니다).

다음 표에서는 Windows 이식 가능한 디바이스에서 정의하는 명령의 범주를 나열합니다. 디바이스 제조업체는 고유한 명령 범주 및 명령 ID를 만들어 고유한 명령을 정의할 수 있습니다. 그러나 제조업체는 아래에 나열된 범주에 명령을 추가해서는 안 됩니다. 이러한 명령은 Microsoft에서 예약했기 때문에 추가하면 안 됩니다.

명령 범주

명령 범주 Description
WPD_CATEGORY_COMMON 모든 개체 및 디바이스에 공통적인 명령입니다.
WPD_CATEGORY_DEVICE_HINTS 최종 사용자 환경을 개선하는 데 사용할 수 있는 선택적 디바이스 정보를 검색하는 데 사용되는 명령입니다.
WPD_CATEGORY_SMS 일반적으로 휴대폰에 노출되는 SMS(짧은 메시지 서비스) 기능을 지원하는 디바이스에 사용되는 명령입니다.
WPD_CATEGORY_STILL_IMAGE_CAPTURE 스틸 이미지 캡처를 지원하는 디바이스에 사용되는 명령입니다.
WPD_CATEGORY_STORAGE 스토리지 기능 개체에 사용되는 명령입니다.

 

이러한 각 형식에 대해 정의된 특정 명령은 명령 유형별로 구성된 다음 표에 제공됩니다.

WPD_CATEGORY_COMMON 범주

명령 Description
WPD_COMMAND_COMMON_RESET_DEVICE 디바이스를 다시 설정합니다.

 

WPD_CATEGORY_DEVICE_HINTS 범주

명령 설명
WPD_COMMAND_DEVICE_HINTS_GET_CONTENT_LOCATION 지정된 형식의 개체를 보유할 수 있는 폴더의 개체 ID를 검색합니다.

 

WPD_CATEGORY_STORAGE 범주

명령 설명
WPD_COMMAND_STORAGE_EJECT 드라이버에서 원격으로 배출할 수 있는 스토리지 매체를 배출합니다.
WPD_COMMAND_STORAGE_FORMAT 디바이스에서 스토리지 기능 개체의 형식을 지정합니다.

 

WPD_CATEGORY_SMS 범주

명령 Description
WPD_COMMAND_SMS_SEND SMS 기능 개체에 의한 SMS 메시지 보내기를 시작합니다.

 

WPD_CATEGORY_STILL_IMAGE_CAPTURE 범주

명령 Description
WPD_COMMAND_STILL_IMAGE_CAPTURE_INITIATE 스틸 이미지 기능 개체에 의해 스틸 이미지 캡처를 시작합니다.

 

프로그래밍 참조