IPortableDeviceConnector

ペアリング済みの MTP/Bluetooth デバイスに対する接続管理およびプロパティ取得のためのメソッドを定義します。

MTP/Bluetooth デバイスに非同期の接続要求を送信します。

このメソッドは HRESULT を返します。戻り値には次の表の値が含まれますが、これらに限定されません。

このメソッドは接続要求をキューに登録し、直ちに制御を返します。デバイスが既に接続されている場合、接続要求は何も行いません。

要求の完了時に通知を受け取るには、アプリケーションは IConnectionRequestCallback インターフェイスへのポインターを指定する必要があります。

以前にペアリングした MTP/Bluetooth デバイスが通信範囲内にある場合、アプリケーションはこのメソッドを呼び出すことで、そのデバイス用の Windows Portable Devices (WPD) クラスドライバースタックをインスタンス化し、WPD API を使用してデバイスと通信できるようになります。

MTP/Bluetooth デバイスに非同期の切断要求を送信します。

このメソッドは HRESULT を返します。戻り値には次の表の値が含まれますが、これらに限定されません。

このメソッドは切断要求をキューに登録し、直ちに制御を返します。

要求の完了時に通知を受け取るには、アプリケーションは IConnectionRequestCallback インターフェイスへのポインターを指定する必要があります。この処理により MTP/Bluetooth リンクが切断され、そのデバイス用の Windows Portable Devices (WPD) クラスドライバースタックが削除されます。

切断が完了すると、WPD API はこのデバイスを列挙しなくなります。

MTP/Bluetooth デバイスの接続要求または切断要求のうち、保留中のものをキャンセルします。

このメソッドは HRESULT を返します。戻り値には次の表の値が含まれますが、これらに限定されません。

指定された MTP/Bluetooth バス列挙子デバイスのプロパティを取得します。

このメソッドは HRESULT を返します。戻り値には次の表の値が含まれますが、これらに限定されません。

このメソッドで取得されるプロパティは、デバイスノードに設定されているものです。プロパティキーの例としては、デバイスが現在接続されているかどうかを示す DEVPKEY_MTPBTH_IsConnected があります。

pPropertyType パラメーターに指定できる値は、統合デバイスプロパティモデルのシステム定義基本データ型です。これらのデータ型名は DEVPROP_TYPE_ というプレフィックスで始まります。

ppData パラメーターで指定されたプロパティデータが不要になったら、アプリケーションは CoTaskMemAlloc を呼び出してこのデータを解放する必要があります。

例

次の例は、ペアリング済みの MTP/Bluetooth デバイスについて DEVPKEY_MTPBTH_IsConnected プロパティを読み取る方法を示しています。

#include <devpkey.h>
#include <PortableDeviceConnectAPI.h>
HRESULT IsDeviceConnected(
__in  IPortableDeviceConnector* pDevice, 
__out BOOL* pIsConnected)
{
    DEVPROPTYPE     typeGet;
    BYTE*           pDataGet;
    UINT32          cbDataGet;
    *pbIsConnected = FALSE; 
    HRESULT hr = pDevice ->GetProperty(&DEVPKEY_MTPBTH_IsConnected,
                                       &typeGet,
                                       &pDataGet,
                                       &cbDataGet);
    if (SUCCEEDED(hr))
    {
        DEVPROP_BOOLEAN bIsConnected = *((DEVPROP_BOOLEAN*)pDataGet);
        if (bIsConnected == DEVPROP_TRUE)
        {
            * pIsConnected = TRUE;
        }
        // Release memory allocated by GetProperty
        CoTaskMemFree(pDataGet);
    }  
    return hr;
}

MTP/Bluetooth バス列挙子デバイスに指定されたプロパティを設定します。

このメソッドは HRESULT を返します。戻り値には次の表の値が含まれますが、これらに限定されません。

このメソッドを呼び出す前に、アプリケーションは管理者ユーザー権限を持っていることを確認する必要があります。

コネクターのプラグ アンド プレイ (PnP) デバイス識別子を取得します。

このメソッドは HRESULT を返します。戻り値には次の表の値が含まれますが、これらに限定されません。

このメソッドで取得される識別子は、ペアリング済みの MTP/Bluetooth デバイスに対する接続および切断の IOCTL 要求を受け取る MTP/Bluetooth バス列挙子デバイスノードのハンドルに対応します。アプリケーションはこの識別子を SetupAPI の関数と組み合わせて使用し、デバイスノードにアクセスできます。

ppwszPnPID パラメーターで指定された識別子が不要になったら、アプリケーションは CoTaskMemAlloc 関数を呼び出してこの識別子を解放する必要があります。