IPortableDeviceCapabilities::GetCommandOptions 메서드(portabledeviceapi.h)

GetCommandOptions 메서드는 디바이스에서 지정된 명령에 대해 지원되는 모든 옵션을 검색합니다.

구문

HRESULT GetCommandOptions(
  [in]  REFPROPERTYKEY        Command,
  [out] IPortableDeviceValues **ppOptions
);

매개 변수

[in] Command

지원되는 옵션을 쿼리하는 명령을 지정하는 REFPROPERTYKEY 입니다. Windows 이식 가능한 디바이스에서 정의한 명령 목록은 명령을 참조하세요.

[out] ppOptions

지원되는 옵션이 포함된 IPortableDeviceValues 인터페이스에 대한 포인터를 수신하는 변수의 주소입니다. 지원되는 옵션이 없으면 값이 포함되지 않습니다. 호출자는 이 인터페이스가 완료되면 이 인터페이스를 해제해야 합니다. 자세한 내용은 설명 부분을 참조하세요.

반환 값

이 메서드는 HRESULT를 반환합니다. 가능한 값에는 다음 표에 있는 값이 포함되지만, 이에 국한되는 것은 아닙니다.

반환 코드	Description
S_OK	메서드가 성공했습니다.

설명

이 메서드는 IPortableDevice::SendCommand를 호출하여 드라이버에서 직접 명령을 호출하려는 애플리케이션에서 호출됩니다. 일부 명령을 사용하면 호출자가 추가 옵션을 지정할 수 있습니다. 예를 들어 일부 드라이버는 WPD_COMMAND_OBJECT_MANAGEMENT_DELETE_OBJECTS 명령을 사용하여 개체를 삭제할 때 재귀 자식 삭제를 지원합니다.

옵션이 간단한 부울 값인 경우 검색된 IPortableDeviceValues 인터페이스의 키가 옵션의 이름이 되고 PROPVARIANT 값은 true 또는 False의 VT_BOOL 값이 됩니다. 옵션에 여러 값이 있는 경우 검색된 PROPVARIANT 값은 지원되는 값을 보유하는 컬렉션 형식이 됩니다.

이 메서드가 WPD_COMMAND_STORAGE_FORMAT 명령에 대해 호출되고 ppOptions 매개 변수가 WPD_OPTION_VALID_OBJECT_IDS 설정된 경우 드라이버는 형식을 지정할 수 있는 디바이스의 각 개체에 대한 식별자를 지정하는 VT_LPWSTR 형식의 IPortableDevicePropVariant 컬렉션을 반환합니다. (이 옵션이 없으면 모든 개체에 대해 format 명령을 사용할 수 있습니다.)

요구 사항

요구 사항	값
대상 플랫폼	Windows
헤더	portabledeviceapi.h
라이브러리	PortableDeviceGUIDs.lib

추가 정보

IPortableDeviceCapabilities 인터페이스