TnbUsbGuidFinder.h

[詳解]

#pragma once
#include "TnbDef.h"
#include <SetupApi.h>
#pragma comment(lib, "setupapi.lib")
 
 
 
//TNB Library
namespace TNB
{
 
 
 
class CAbstractUsbGuidFinder : CCopyImpossible
{
    GUID            m_guid;             
    HDEVINFO        m_hDevInfo;         
    DWORD           m_dwIndex;          
    DWORD           m_dwLastError;      
 
    bool m_GetDevInfo(DWORD index)
    {
        ASSERTLIB( m_hDevInfo != NULL );
        SP_DEVICE_INTERFACE_DATA tDevIfData;
        tDevIfData.cbSize = sizeof(tDevIfData); // サイズを設定
        // デバイス情報セット内の各デバイス インターフェースを列挙
        if ( ! ::SetupDiEnumDeviceInterfaces(
                    m_hDevInfo,     // インターフェイス情報を取得するデバイスが含まれているデバイス情報セットへのポインタ
                    NULL,           // 未使用
                    &m_guid,        // 要求するインターフェイスのデバイスインターフェイスクラスを指定する、1つのGUIDへのポインタ
                    index,          // デバイス情報セット内のインターフェイスリストに対して、0で始まるインデックス番号
                    &tDevIfData     // 関数が成功した場合に、書き込みの完了したSP_DEVICE_INTERFACE_DATA構造体を保持するバッファへのポインタ
            )
        )
        {
            m_dwLastError = ::GetLastError();
        }
        else
        {
            // 指定されたデバイスインターフェイスに関する詳細情報を返します
            // 詳細データ構造体サイズを取得
            DWORD dwReqSize;
            SP_DEVINFO_DATA tDevInfoData;
            tDevInfoData.cbSize = sizeof(tDevInfoData);
            ::SetupDiGetDeviceInterfaceDetail(
                    m_hDevInfo,     // インターフェイスとその基になるデバイスが含まれるデバイス情報セットへのポインタ
                    &tDevIfData,    // インターフェイスを識別する1つのSP_DEVICE_INTERFACE_DATA構造体へのポインタ
                    NULL,           // サイズ取得するため、NULL   （指定されたインターフェイスに関する情報を受け取る1つのSP_DEVICE_INTERFACE_DETAIL_DATA構造体へのポインタ）
                    0,              // サイズ取得するため、0  （DeviceInterfaceDetailDataが指すバッファのサイズ）
                    &dwReqSize,     // DeviceInterfaceDetailDataが指すバッファが必要とするサイズを受け取る、1つの変数へのポインタ
                    &tDevInfoData   // 要求されたインターフェイスを公開しているデバイスに関する情報を受け取る、1つのSP_DEVINFO_DATA構造体へのポインタ
                );
            CWorkMem work(dwReqSize);
            PSP_DEVICE_INTERFACE_DETAIL_DATA pDevIfDetailData
                        = reinterpret_cast<PSP_DEVICE_INTERFACE_DETAIL_DATA>(work.Ref());
            pDevIfDetailData->cbSize = sizeof(SP_DEVICE_INTERFACE_DETAIL_DATA);
            if ( ! ::SetupDiGetDeviceInterfaceDetail(
                    m_hDevInfo,         // インターフェイスとその基になるデバイスが含まれるデバイス情報セットへのポインタ
                    &tDevIfData,        // インターフェイスを識別する1つのSP_DEVICE_INTERFACE_DATA構造体へのポインタ
                    pDevIfDetailData,   // 指定されたインターフェイスに関する情報を受け取る1つのSP_DEVICE_INTERFACE_DETAIL_DATA構造体へのポインタ
                    dwReqSize,          // DeviceInterfaceDetailDataが指すバッファのサイズ
                    &dwReqSize,         // DeviceInterfaceDetailDataが指すバッファが必要とするサイズを受け取る、1つの変数へのポインタ
                    &tDevInfoData       // 要求されたインターフェイスを公開しているデバイスに関する情報を受け取る、1つのSP_DEVINFO_DATA構造体へのポインタ
                )
            )
            {
                m_dwLastError = ::GetLastError();
            }
            else
            {
                m_dwLastError = OnFound(pDevIfDetailData->DevicePath);
            }
        }
        return m_dwLastError == ERROR_SUCCESS;
    }
    
    bool m_Find(void)
    {
        Close();
        // 指定されたクラスに所属するすべてのデバイスが含まれている1つのデバイス情報セットを返します
        m_hDevInfo = ::SetupDiGetClassDevs(
                &m_guid,                                // セットアップクラスのクラスGUIDへのポインタ
                NULL,                                   // システムのすべてのデバイスインスタンスに関するデバイス情報を取得
                0,                                      // このセットのメンバに関連するすべてのユーザーインターフェイスが利用する、トップレベルウィンドウのハンドルを指定
                (DIGCF_PRESENT | DIGCF_DEVICEINTERFACE) // 現在存在するデバイス | ClassGuidで指定されたインターフェイスクラスに所属するインターフェイスを公開しているデバイス
        );
        m_dwIndex = 0;
        m_dwLastError = 0;
        if ( m_hDevInfo != NULL )
        {
            m_GetDevInfo(m_dwIndex);
            if ( m_dwLastError != ERROR_NO_MORE_ITEMS )
            {
                m_dwIndex++;
                return true;
            }
            Close();
        }
        else
        {
            m_dwLastError = ::GetLastError();
        }
        return false;
    }
protected:
 
    virtual DWORD OnFound(LPCTSTR lpszDevicePath) = 0;
 
    virtual void OnClosed(void) = 0;
 
public:
 
    CAbstractUsbGuidFinder(void) : m_hDevInfo(NULL), m_dwIndex(0), m_dwLastError(0)
    {
        Zero(m_guid);
    }
 
    void Close(void)
    {
        if ( m_hDevInfo != NULL )
        {
            ::SetupDiDestroyDeviceInfoList(m_hDevInfo);
            m_hDevInfo = NULL;
            OnClosed();
        }
    }
 
    bool IsFinding(void) const
    {
        return m_hDevInfo != NULL;
    }
    
    bool Find(const GUID& g)
    {
        m_guid = g;
        return m_Find();
    }
 
    bool Next(void)
    {
        m_GetDevInfo(m_dwIndex);
        if ( m_dwLastError == ERROR_NO_MORE_ITEMS )
        {
            Close();
            return false;
        }
        m_dwIndex++;
        return true;
    }
 
    DWORD GetLastError(void) const
    {
        return m_dwLastError;
    }
};
 
 
 
class CUsbGuidFinder : public CAbstractUsbGuidFinder
{
    DEFSUPER(CAbstractUsbGuidFinder);
    CSimpleStr  m_devicePathName;   
protected:
    virtual DWORD OnFound(LPCTSTR lpszDevicePath)
    {
        m_devicePathName = lpszDevicePath;
        return 0;
    }
 
    virtual void OnClosed(void)
    {
        m_devicePathName.Empty();
    }
 
public:
    CUsbGuidFinder(void)
    {
    }
 
    LPCTSTR GetDevicePathName(void) const
    {
        return m_devicePathName;
    }
};
 
 
 
}; // TNB