WinUSB テンプレートに基づいて Windows デスクトップアプリを記述する

[アーティクル]
01/17/2024

USB デバイスと通信する Windows デスクトップアプリを記述する最も簡単な方法は、C/C++ WinUSB テンプレートを使用することです。このテンプレートには、Windows Driver Kit (WDK) (Windows 用デバッグツールを使用) と Microsoft Visual Studio (Professional または Ultimate) を統合した環境が必要です。このテンプレートを出発点として使用できます。

開始する前に

統合開発環境を設定するには、まず Microsoft Visual Studio Ultimate 2019 または Microsoft Visual Studio Professional 2019 をインストールしてから、WDK をインストールします。 Visual Studio と WDK のセットアップ方法に関する情報は、WDK ダウンロードページをご覧ください。
Windows 用デバッグツールは、WDK をインストールするときに組み込まれます。詳細については、「Windows 用デバッグツールのダウンロードとインストール」を参照してください。

WinUSB アプリケーションの作成

テンプレートからアプリケーションを作成するには:

[新しいプロジェクト] ダイアログボックスの上部にある検索ボックスに、もう一度「USB」と入力します。
中央のウィンドウで、[WinUSB アプリケーション (ユニバーサル)] を選択します。
[次へ] を選択します。
プロジェクト名を入力し、保存場所を選択して、[作成] を選択します。

次のスクリーンショットは、WinUSB アプリケーション (ユニバーサル) テンプレートの [新しいプロジェクト] ダイアログボックスを示しています。

このトピックでは、Visual Studio プロジェクトの名前が USB Application1 であることを前提としています。

Visual Studio により、1 つのプロジェクトと 1 つのソリューションが作成されます。次のスクリーンショットに示すように、ソリューション、プロジェクト、およびプロジェクトに属するファイルは、[ソリューションエクスプローラー] ウィンドウで確認できます。 ([ソリューションエクスプローラー] ウィンドウが表示されない場合は、[表示] メニューから [ソリューションエクスプローラー] を選択します)。このソリューションには、USB Application1 という名前の C++ アプリケーションプロジェクトが含まれています。

USB Application1 プロジェクトには、アプリケーションのソースファイルがあります。アプリケーションのソースコードを確認する場合は、[ソースファイル] の下に表示されるすべてのファイルを開くことができます。
ソリューションにドライバーパッケージプロジェクトを追加します。ソリューション (ソリューション 'USB Application1') を長押し (または右クリック) し、次のスクリーンショットに示すように [追加>新しいプロジェクト] を選択します。
[新しいプロジェクト] ダイアログボックスの上部にある検索ボックスに、もう一度「USB」と入力します。
中央のウィンドウで、[WinUSB INF ドライバーパッケージ] を選択します。
[次へ] を選択します。
プロジェクト名を入力して、[作成] を選択します。

次のスクリーンショットは、WinUSB INF ドライバーパッケージ テンプレートの [新しいプロジェクト] ダイアログボックスを示しています。

このトピックでは、Visual Studio プロジェクトの名前が USB Application1 Package であることを前提としています。

USB Application1 Package プロジェクトには、デバイスドライバーとしてマイクロソフト提供の Winusb.sys ドライバーをインストールするために使用される INF ファイルが含まれています。

次のスクリーンショットに示すように、ソリューションエクスプローラーには両方のプロジェクトが含まれているはずです。
INF ファイル USBApplication1.inf で、次のコードを見つけます: %DeviceName% =USB_Install, USB\VID_vvvv&PID_pppp
VID_vvvv&PID_pppp をデバイスのハードウェア ID に置き換えます。デバイスマネージャーからハードウェア ID を取得します。デバイスマネージャーで、デバイスのプロパティを表示します。 [詳細] タブで、[ハードウェアID] プロパティの値を表示します。
[ソリューションエクスプローラー] ウィンドウで、ソリューション 'USB Application1' (2 つのプロジェクトのうち 2 つ) を選択して長押し (または右クリック) して、[構成マネージャー] を選択します。アプリケーションプロジェクトとパッケージプロジェクトの両方の構成とプラットフォームを選択します。この演習では、次のスクリーンショットに示すように、[デバッグ] と [x64] を選択します。

Screenshot that shows the

プロジェクトのビルド、デプロイ、デバッグ

この演習ではこれまで、Visual Studio を使用してプロジェクトを作成しました。次に、デバイスが接続されているデバイスを構成する必要があります。このテンプレートでは、Winusb ドライバーがデバイスのドライバーとしてインストールされている必要があります。

テスト環境とデバッグ環境には、次の機能があります。

2 台のコンピューターセットアップ: ホストコンピューターとターゲットコンピューター。ホストコンピューター上の Visual Studio でプロジェクトを開発し、ビルドします。デバッガーはホストコンピュータ上で実行され、Visual Studio のユーザーインターフェイスで使用できます。アプリケーションをテストしてデバッグすると、ドライバーはターゲットコンピュータ上で実行されます。
単一コンピューターのセットアップ: ターゲットとホストは 1 台のコンピューターで実行されます。 Visual Studio でプロジェクトを開発してビルドし、デバッガーとアプリケーションを実行します。

次の手順に従って、アプリケーションとドライバーをデプロイ、インストール、読み込み、デバッグできます。

2 台のコンピューターのセットアップ
1. 「ドライバーのデプロイとテスト用にコンピューターをプロビジョニングする」の手順に従って、ターゲットコンピューターをプロビジョニングします。注: プロビジョニングにより、WDKRemoteUser という名前のターゲットコンピューターにユーザーが作成されます。プロビジョニングが完了すると、ユーザーが WDKRemoteUser に切り替わります。
2. ホストコンピューターで、Visual Studio でソリューションを開きます。
3. main.cpp で、OpenDevice 呼び出しの前にこの行を追加します。
```
system ("pause")
```
この行を使用すると、起動時にアプリケーションが一時停止します。これはリモートデバッグで役立ちます。
1. pch.h には、次の行を含めます。
```
#include <cstdlib>
```
前の手順の system() 呼び出しには、この include ステートメントが必要です。
1. [ソリューションエクスプローラー] ウィンドウで、[USB Application1 Package] を選択して長押し (または右クリック) して、[プロパティ] を選択します。
2. 次のスクリーンショットに示すように、[USB Application1 Package プロパティページ] ウィンドウの左側のウィンドウで、[構成プロパティ>ドライバーのインストール>デプロイ] に移動します。
3. デプロイ前に以前のドライバーバージョンを削除にチェックを入れます。
4. [リモートコンピューター名] で、テストとデバッグ用に構成したコンピューターの名前を選択します。この演習では、dbg-target という名前のコンピューターを使用します。
5. [インストール/再インストールと確認] を選択します。適用を選択します。
6. プロパティページで、[構成プロパティ > デバッグ] に移動し、次のスクリーンショットに示すように、[Windows のデバッグツール – リモートデバッガー] を選択します。
7. [ビルド] メニューの [ソリューションのビルド] をクリックします。 Visual Studio では、出力ウィンドウにビルドの進捗状況が表示されます。 ([出力] ウィンドウが表示されない場合は、[表示] メニューから [出力] を選択します)。この演習では、Windows 10 を実行する x64 システム用のプロジェクトをビルドしました。
8. [ビルド] メニューの [ソリューションの配置] を選択します。

ターゲットコンピューターでは、ドライバーのインストールスクリプトが実行されていることがわかります。ドライバーファイルは、ターゲットコンピューターの %Systemdrive%\drivertest\drivers フォルダーにコピーされます。 .inf、.cat、test cert、.sys など、必要なファイルがすべて %systemdrive%\drivertest\drivers フォルダーに存在することを確認します。デバイスは、エラーなしでデバイスマネージャーに表示される必要があります。

ホストコンピューターの [出力] ウィンドウにこのメッセージが表示されます。

Deploying driver files for project
"<path>\visual studio 14\Projects\USB Application1\USB Application1 Package\USB Application1 Package.vcxproj".
Deployment may take a few minutes...
========== Build: 1 succeeded, 0 failed, 1 up-to-date, 0 skipped ==========

アプリケーションをデバッグするには

ホストコンピューターで、ソリューションフォルダー内の [x64 > Win8.1Debug] に移動します。
ターゲットコンピューターに、UsbApplication1.exe アプリケーションの実行可能ファイルをコピーします。
ターゲットコンピューターでアプリケーションを起動します。
ホストコンピューターで、[デバッグ] メニューの [プロセスにアタッチする] を選択します。
このウィンドウで、トランスポートとして Windows ユーザーモードデバッガー (Windows 用デバッグツール) を選択し、ターゲットコンピューターの名前 (この場合は dbg-target) を、この図に示すように修飾子として選択します。
そのプロセスを [選択可能なプロセス] の一覧から選択し、[アタッチ] を選択します。 [イミディエイトウィンドウ] を使用するか、[デバッグ] メニューのオプションを使用してデバッグできるようになりました。

前の手順では、Windows 用のデバッグツール – リモートデバッガーを使用してアプリケーションをデバッグします。 リモート Windows デバッガー (Visual Studio に含まれるデバッガー) を使用する場合は、次の手順に従います。

ターゲットコンピューターで、ファイアウォールで許可されているアプリの一覧に msvsmon.exe を追加します。
C:\DriverTest\msvsmon\msvsmon.exe にある Visual Studio リモートデバッグモニターを起動します。
C:\remotetemp のような作業フォルダーを作成します。
ターゲットコンピューター上の作業フォルダーに UsbApplication1.exe アプリケーションの実行可能ファイルをコピーします。
ホストコンピューターの Visual Studio で、USB Application1 Package プロジェクトを右クリックし、[プロジェクトのアンロード] を選択します。
USB Application1 プロジェクトを長押し (または右クリック) して、プロジェクトのプロパティで [構成プロパティ] ノードを展開し、[デバッグ] を選択します。
[起動するデバッガー] を [リモート Windows デバッガー] に変更します。
「ローカルでビルドされたプロジェクトのリモートデバッグ」の手順に従って、リモートコンピューターで実行可能ファイルを実行するようにプロジェクト設定を変更します。 作業ディレクトリとリモートコマンドのプロパティに、ターゲットコンピューター上のフォルダーが反映されていることを確認します。
アプリケーションをデバッグするには、[ビルド] メニューから [デバッグの開始] を選択するか、F5 キーを押します。

1 台のコンピューターのセットアップ:
1. アプリケーションとドライバーインストールパッケージをビルドするには、[ビルド] メニューの [ソリューションのビルド] を選択します。 Visual Studio では、出力ウィンドウにビルドの進捗状況が表示されます。 ([出力] ウィンドウが表示されない場合は、[表示] メニューから [出力] を選択します)。この演習では、Windows 10 を実行する x64 システム用のプロジェクトをビルドしました。
2. ビルドされたドライバーパッケージを表示するには、Windows エクスプローラーで USB Application1 フォルダーに移動し、[x64] > [Debug] > [USB Application1 Package] に移動します。ドライバーパッケージにはいくつかのファイルが含まれています。MyDriver.inf はドライバーのインストール時に Windows が使用する情報ファイルで、mydriver.cat はインストーラーがドライバーパッケージのテスト署名を検証するために使用するカタログファイルです。これらのファイルを次のスクリーンショットに示します。
  
  パッケージに含まれるドライバーファイルはありません。これは、INF ファイルが Windows\System32 フォルダーにあるインボックスドライバー Winusb.sys を参照しているためです。
3. ドライバーを手動でインストールします。 [デバイスマネージャー] で、パッケージ内の INF を指定してドライバーを更新します。前のセクションに示すように、[ソリューション] フォルダーにあるドライバーパッケージをポイントします。エラー DriverVer set to a date in the future が表示された場合は、[INF パッケージプロジェクト設定] > [Inf2Cat] > [全般] > [現地時刻の使用] > [はい] を設定します。
4. USB Application1 プロジェクトを長押し (または右クリック) して、プロジェクトのプロパティで [構成プロパティ] ノードを展開し、[デバッグ] を選択します。
5. [起動するデバッガー] を [ローカル Windows デバッガー] に変更します。
6. USB Application1 Package プロジェクトを長押し (または右クリック) して、[プロジェクトのアンロード] を選択します。
7. アプリケーションをデバッグするには、[ビルド] メニューから [デバッグの開始] を選択するか、F5 キーを押します。

テンプレートコードの説明

テンプレートは、デスクトップアプリケーションの開始点です。 USB Application1 プロジェクトには、ソースファイル device.cpp と main.cpp があります。

main.cpp ファイルには、アプリケーションのエントリポイント、_tmain が含まれています。 device.cpp には、デバイスのハンドルを開いたり閉じたりするすべてのヘルパー関数が含まれています。

テンプレートには、device.h という名前のヘッダーファイルもあります。このファイルには、デバイスインターフェイス GUID (後述) と、アプリケーションによって取得された情報を格納する DEVICE_DATA 構造体の定義が含まれています。たとえば、OpenDevice によって取得され、後続の操作で使用される WinUSB インターフェイスハンドルを格納します。

typedef struct _DEVICE_DATA {

    BOOL                    HandlesOpen;
    WINUSB_INTERFACE_HANDLE WinusbHandle;
    HANDLE                  DeviceHandle;
    TCHAR                   DevicePath[MAX_PATH];

} DEVICE_DATA, *PDEVICE_DATA;

デバイスのインスタンスパスの取得 - device.cpp の RetrieveDevicePath を参照してください

USB デバイスにアクセスするために、アプリケーションは CreateFile を呼び出してデバイスの有効なファイルハンドルを作成します。その呼び出しでは、アプリケーションはデバイスパスインスタンスを取得する必要があります。デバイスパスを取得するために、アプリは SetupAPI ルーチンを使用し、Winusb.sysのインストールに使用された INF ファイル内のデバイスインターフェイス GUID を指定します。 Device.h は、GUID_DEVINTERFACE_USBApplication1 という名前の GUID 定数を宣言します。これらのルーチンを使用して、アプリケーションは、指定されたデバイスインターフェイスクラス内のすべてのデバイスを列挙して、デバイスのデバイスパスを取得します。

HRESULT
RetrieveDevicePath(
    _Out_bytecap_(BufLen) LPTSTR DevicePath,
    _In_                  ULONG  BufLen,
    _Out_opt_             PBOOL  FailureDeviceNotFound
    )
/*++

Routine description:

    Retrieve the device path that can be used to open the WinUSB-based device.

    If multiple devices have the same device interface GUID, there is no
    guarantee of which one will be returned.

Arguments:

    DevicePath - On successful return, the path of the device (use with CreateFile).

    BufLen - The size of DevicePath's buffer, in bytes

    FailureDeviceNotFound - TRUE when failure is returned due to no devices
        found with the correct device interface (device not connected, driver
        not installed, or device is disabled in Device Manager); FALSE
        otherwise.

Return value:

    HRESULT

--*/
{
    BOOL                             bResult = FALSE;
    HDEVINFO                         deviceInfo;
    SP_DEVICE_INTERFACE_DATA         interfaceData;
    PSP_DEVICE_INTERFACE_DETAIL_DATA detailData = NULL;
    ULONG                            length;
    ULONG                            requiredLength=0;
    HRESULT                          hr;

    if (NULL != FailureDeviceNotFound) {

        *FailureDeviceNotFound = FALSE;
    }

    //
    // Enumerate all devices exposing the interface
    //
    deviceInfo = SetupDiGetClassDevs(&GUID_DEVINTERFACE_USBApplication1,
                                     NULL,
                                     NULL,
                                     DIGCF_PRESENT | DIGCF_DEVICEINTERFACE);

    if (deviceInfo == INVALID_HANDLE_VALUE) {

        hr = HRESULT_FROM_WIN32(GetLastError());
        return hr;
    }

    interfaceData.cbSize = sizeof(SP_DEVICE_INTERFACE_DATA);

    //
    // Get the first interface (index 0) in the result set
    //
    bResult = SetupDiEnumDeviceInterfaces(deviceInfo,
                                          NULL,
                                          &GUID_DEVINTERFACE_USBApplication1,
                                          0,
                                          &interfaceData);

    if (FALSE == bResult) {

        //
        // We would see this error if no devices were found
        //
        if (ERROR_NO_MORE_ITEMS == GetLastError() &&
            NULL != FailureDeviceNotFound) {

            *FailureDeviceNotFound = TRUE;
        }

        hr = HRESULT_FROM_WIN32(GetLastError());
        SetupDiDestroyDeviceInfoList(deviceInfo);
        return hr;
    }

    //
    // Get the size of the path string
    // We expect to get a failure with insufficient buffer
    //
    bResult = SetupDiGetDeviceInterfaceDetail(deviceInfo,
                                              &interfaceData,
                                              NULL,
                                              0,
                                              &requiredLength,
                                              NULL);

    if (FALSE == bResult && ERROR_INSUFFICIENT_BUFFER != GetLastError()) {

        hr = HRESULT_FROM_WIN32(GetLastError());
        SetupDiDestroyDeviceInfoList(deviceInfo);
        return hr;
    }

    //
    // Allocate temporary space for SetupDi structure
    //
    detailData = (PSP_DEVICE_INTERFACE_DETAIL_DATA)
        LocalAlloc(LMEM_FIXED, requiredLength);

    if (NULL == detailData)
    {
        hr = E_OUTOFMEMORY;
        SetupDiDestroyDeviceInfoList(deviceInfo);
        return hr;
    }

    detailData->cbSize = sizeof(SP_DEVICE_INTERFACE_DETAIL_DATA);
    length = requiredLength;

    //
    // Get the interface's path string
    //
    bResult = SetupDiGetDeviceInterfaceDetail(deviceInfo,
                                              &interfaceData,
                                              detailData,
                                              length,
                                              &requiredLength,
                                              NULL);

    if(FALSE == bResult)
    {
        hr = HRESULT_FROM_WIN32(GetLastError());
        LocalFree(detailData);
        SetupDiDestroyDeviceInfoList(deviceInfo);
        return hr;
    }

    //
    // Give path to the caller. SetupDiGetDeviceInterfaceDetail ensured
    // DevicePath is NULL-terminated.
    //
    hr = StringCbCopy(DevicePath,
                      BufLen,
                      detailData->DevicePath);

    LocalFree(detailData);
    SetupDiDestroyDeviceInfoList(deviceInfo);

    return hr;
}

前の関数では、アプリケーションは次のルーチンを呼び出してデバイスパスを取得します。

デバイス情報セットへのハンドルを取得する SetupDiGetClassDevs 。指定されたデバイスインターフェイスクラスに一致するすべてのインストール済みデバイスに関する情報を含む配列、GUID_DEVINTERFACE_USBApplication1。 デバイスインターフェイスと呼ばれる配列内の各要素は、システムにインストールおよび登録されているデバイスに対応します。デバイスインターフェイスクラスは、INF ファイルで定義したデバイスインターフェイス GUID を渡すことによって識別されます。この関数は、HDEVINFO ハンドルをデバイス情報セットに返します。
SetupDiEnumDeviceInterfaces を使用して、デバイス情報セット内のデバイスインターフェイスを列挙し、デバイスインターフェイスに関する情報を取得します。

この呼び出しには、次のアイテムが必要です。
- 初期化された呼び出し元によって割り当てられた SP_DEVICE_INTERFACE_DATA 構造体。cbSize メンバーが構造体のサイズに設定されています。
- 手順 1 の HDEVINFO ハンドル。
- INF ファイルで定義したデバイスインターフェイス GUID。
  
  SetupDiEnumDeviceInterfaces は、デバイスインターフェイスの指定したインデックスのデバイス情報セット配列を検索し、初期化された SP_DEVICE_INTERFACE_DATA 構造体にインターフェイスに関する基本的なデータを入力します。
デバイス情報セット内のすべてのデバイスインターフェイスを列挙するには、関数が FALSE を返し、そのエラーのエラーコードが ERROR_NO_MORE_ITEMS になるまで、ループで SetupDiEnumDeviceInterfaces を呼び出ます。 ERROR_NO_MORE_ITEMS エラーコードは、GetLastError を呼び出すことによって取得できます。反復処理のたびに、メンバーインデックスをインクリメントします。

または、SetupDiEnumDeviceInfo を呼び出して、デバイス情報セットを列挙し、呼び出し元によって割り当てられた SP_DEVINFO_DATA 構造体で、インデックスで指定されたデバイスインターフェイス要素に関する情報を返すことができます。その後、SetupDiEnumDeviceInterfaces 関数の DeviceInfoData パラメーターで、この構造体への参照を渡すことができます。
デバイスインターフェイスの詳細なデータを取得するための SetupDiGetDeviceInterfaceDetail 。情報は、SP_DEVICE_INTERFACE_DETAIL_DATA 構造体で返されます。 SP_DEVICE_INTERFACE_DETAIL_DATA 構造体のサイズは異なるため、SetupDiGetDeviceInterfaceDetail は 2 回呼び出されます。最初の呼び出しでは、SP_DEVICE_INTERFACE_DETAIL_DATA 構造体に割り当てるバッファーサイズを取得します。 2 番目の呼び出しでは、割り当てられたバッファーにインターフェイスに関する詳細情報が入力されます。
1. DeviceInterfaceDetailData パラメーターを NULL に設定して SetupDiGetDeviceInterfaceDetail を呼び出します。この関数は、requiredlength パラメーターで正しいバッファーサイズを返します。この呼び出しは、ERROR_INSUFFICIENT_BUFFER エラーコードで失敗します。このエラーコードが発生します。
2. requiredlength パラメーターで取得された適切なバッファーサイズに基づいて、SP_DEVICE_INTERFACE_DETAIL_DATA 構造体にメモリを割り当てます。
3. SetupDiGetDeviceInterfaceDetail をもう一度呼び出し、DeviceInterfaceDetailData パラメーターで初期化された構造体への参照を渡します。関数が戻ると、構造体にはインターフェイスに関する詳細情報が入力されます。デバイスパスは、SP_DEVICE_INTERFACE_DETAIL_DATA 構造体の DevicePath メンバーにあります。

デバイスのファイルハンドルの作成

device.cpp の OpenDevice を参照してください。

デバイスと対話するには、デバイス上の最初の (既定の) インターフェイスへの WinUSB インターフェイスハンドルが必要です。テンプレートコードは、ファイルハンドルと WinUSB インターフェイスハンドルを取得して、DEVICE_DATA 構造体に格納します。

HRESULT
OpenDevice(
    _Out_     PDEVICE_DATA DeviceData,
    _Out_opt_ PBOOL        FailureDeviceNotFound
    )
/*++

Routine description:

    Open all needed handles to interact with the device.

    If the device has multiple USB interfaces, this function grants access to
    only the first interface.

    If multiple devices have the same device interface GUID, there is no
    guarantee of which one will be returned.

Arguments:

    DeviceData - Struct filled in by this function. The caller should use the
        WinusbHandle to interact with the device, and must pass the struct to
        CloseDevice when finished.

    FailureDeviceNotFound - TRUE when failure is returned due to no devices
        found with the correct device interface (device not connected, driver
        not installed, or device is disabled in Device Manager); FALSE
        otherwise.

Return value:

    HRESULT

--*/
{
    HRESULT hr = S_OK;
    BOOL    bResult;

    DeviceData->HandlesOpen = FALSE;

    hr = RetrieveDevicePath(DeviceData->DevicePath,
                            sizeof(DeviceData->DevicePath),
                            FailureDeviceNotFound);

    if (FAILED(hr)) {

        return hr;
    }

    DeviceData->DeviceHandle = CreateFile(DeviceData->DevicePath,
                                          GENERIC_WRITE | GENERIC_READ,
                                          FILE_SHARE_WRITE | FILE_SHARE_READ,
                                          NULL,
                                          OPEN_EXISTING,
                                          FILE_ATTRIBUTE_NORMAL | FILE_FLAG_OVERLAPPED,
                                          NULL);

    if (INVALID_HANDLE_VALUE == DeviceData->DeviceHandle) {

        hr = HRESULT_FROM_WIN32(GetLastError());
        return hr;
    }

    bResult = WinUsb_Initialize(DeviceData->DeviceHandle,
                                &DeviceData->WinusbHandle);

    if (FALSE == bResult) {

        hr = HRESULT_FROM_WIN32(GetLastError());
        CloseHandle(DeviceData->DeviceHandle);
        return hr;
    }

    DeviceData->HandlesOpen = TRUE;
    return hr;
}

アプリは CreateFile を呼び出し、前に取得したデバイスパスを指定してデバイスのファイルハンドルを作成します。 WinUSB はこの設定に依存するため、FILE_FLAG_OVERLAPPED フラグを使用します。
デバイスのファイルハンドルを使用して、アプリは WinUSB インターフェイスハンドルを作成します。 WinUSB 関数では、このハンドルを使用して、ファイルハンドルではなくターゲットデバイスを識別します。 WinUSB インターフェイスハンドルを取得するために、アプリはファイルハンドルを渡すことによって WinUsb_Initialize を呼び出します。後続の呼び出しで受信したハンドルを使用して、デバイスから情報を取得し、I/O 要求をデバイスに送信します。

デバイスハンドルを解放する - device.cpp の CloseDevice を参照してください

テンプレートコードは、デバイスのファイルハンドルと WinUSB インターフェイスハンドルを解放するコードを実装します。

このチュートリアルの「デバイス用のファイルハンドルの作成」セクションの説明に従って、CreateFile によって作成されたハンドルを解放する CloseHandle。
WinUsb_Free は、デバイスの WinUSB インターフェイスハンドルを解放します。WinUsb_Initialize によって返されます。

VOID
CloseDevice(
    _Inout_ PDEVICE_DATA DeviceData
    )
/*++

Routine description:

    Perform required cleanup when the device is no longer needed.

    If OpenDevice failed, do nothing.

Arguments:

    DeviceData - Struct filled in by OpenDevice

Return value:

    None

--*/
{
    if (FALSE == DeviceData->HandlesOpen) {

        //
        // Called on an uninitialized DeviceData
        //
        return;
    }

    WinUsb_Free(DeviceData->WinusbHandle);
    CloseHandle(DeviceData->DeviceHandle);
    DeviceData->HandlesOpen = FALSE;

    return;
}

次のステップ

次に、次のトピックを参照して、デバイス情報の取得とデバイスへのデータ転送の送信を行います。

WinUSB ファンクションを使用して USB デバイスにアクセスする

デバイスの速度、インターフェイス記述子、関連するエンドポイント、およびそのパイプなどの USB 固有の情報をデバイスにクエリする方法について説明します。
WinUSB デスクトップアプリから USB 等時性転送を送信する

USB デバイスの等時性エンドポイントとの間でデータを転送します。

次の方法で共有

WinUSB テンプレートに基づいて Windows デスクトップアプリを記述する

開始する前に

WinUSB アプリケーションの作成

プロジェクトのビルド、デプロイ、デバッグ

アプリケーションをデバッグするには

テンプレートコードの説明

デバイスのインスタンスパスの取得 - device.cpp の RetrieveDevicePath を参照してください

デバイスのファイルハンドルの作成

デバイスハンドルを解放する - device.cpp の CloseDevice を参照してください

次のステップ

フィードバック

その他のリソース

次の方法で共有

WinUSB テンプレートに基づいて Windows デスクトップ アプリを記述する

開始する前に

WinUSB アプリケーションの作成

プロジェクトのビルド、デプロイ、デバッグ

アプリケーションをデバッグするには

テンプレート コードの説明

デバイスのインスタンス パスの取得 - device.cpp の RetrieveDevicePath を参照してください

デバイスのファイル ハンドルの作成

デバイス ハンドルを解放する - device.cpp の CloseDevice を参照してください

次のステップ

関連トピック

フィードバック

その他のリソース

WinUSB テンプレートに基づいて Windows デスクトップアプリを記述する

テンプレートコードの説明

デバイスのインスタンスパスの取得 - device.cpp の RetrieveDevicePath を参照してください

デバイスのファイルハンドルの作成

デバイスハンドルを解放する - device.cpp の CloseDevice を参照してください