IPortableDeviceCapabilities::GetCommandOptions メソッド (portabledeviceapi.h)

GetCommandOptions メソッドは、デバイスで指定されたコマンドでサポートされているすべてのオプションを取得します。

構文

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

パラメーター

[in] Command

サポートされているオプションを照会するコマンドを指定する REFPROPERTYKEY 。 Windows ポータブル デバイスで定義されているコマンドの一覧については、「 コマンド」を参照してください。

[out] ppOptions

サポートされているオプションを含む IPortableDeviceValues インターフェイスへのポインターを受け取る変数のアドレス。 サポートされているオプションがない場合、値は含まれません。 呼び出し元は、このインターフェイスの使用が完了したら、このインターフェイスを解放する必要があります。 詳細については、「解説」を参照してください。

戻り値

このメソッドは HRESULT を返します。 有効な値を次の表に示しますが、これ以外にもあります。

注釈

このメソッドは、 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 コマンドはすべてのオブジェクトで使用できます)。

要件

こちらもご覧ください

IPortableDeviceCapabilities インターフェイス