共用方式為


IPortableDeviceCapabilities::GetCommandOptions 方法 (portabledeviceapi.h)

GetCommandOptions 方法會擷取裝置上指定命令的所有支持選項。

語法

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

參數

[in] Command

REFPROPERTYKEY,指定要查詢支援選項的命令。 如需 Windows 可攜式裝置所定義的命令清單,請參閱 命令

[out] ppOptions

接收 IPortableDeviceValues 介面指標的變數位址,其中包含支持的選項。 如果未支援任何選項,則不會包含任何值。 呼叫端必須在使用此介面完成時釋放這個介面。 如需詳細資訊,請參閱<備註>。

傳回值

方法會傳回 HRESULT。 可能的值包括 (但不限於) 下表中的這些值。

傳回碼 描述
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 命令適用於所有 objects.)

規格需求

需求
目標平台 Windows
標頭 portabledeviceapi.h
程式庫 PortableDeviceGUIDs.lib

另請參閱

IPortableDeviceCapabilities 介面