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 介面