ドライバーストアから実行する

[アーティクル]
03/27/2024

[ドライバーストアから実行する] を使用している INF は、インストール時にドライバーパッケージファイルの場所を指定するために DIRID 13 を使用する INF を意味します。

INF によってペイロードされた "ドライバーストアから実行する" ファイルの場合、INF 内のそのファイルに対する SourceDisksFiles エントリにリストされている subdir は、INF 内の同じファイルに対する DestinationDirs エントリにリストされている subdir と一致している 必要があります。

さらに、 CopyFiles ディレクティブを使用して、ドライバーストアから実行されるファイルの名前を変更することはできません。これらの制限は、デバイスにINFをインストールしてもドライバーストアディレクトリに新しいファイルが作成されないようにするために必要です。

SourceDisksFiles エントリには同じファイル名の複数のエントリを含めることはできず、CopyFilesを使用してファイル名を変更することはできないため、INF が参照するすべての「ドライバーストアから実行」ファイルには一意のファイル名が必要です。

ドライバーパッケージは Windows 10 1709 以降、[ドライバーストアから実行する] を全般的にサポートしています。ただし、特定のデバイススタックでは、そのスタックにプラグインするために提供する必要があるファイルに追加の制限が課される場合があります。いくつかの例は、Windows 10 1803 まで「ドライバーストアからの実行」をサポートしていなかったデバイススタックです。

UMDF ドライバーバイナリ: 詳細については、「UMDF ドライバーの読み込み場所の制限」を参照してください
UEFI ファームウェア更新: 詳細については、「更新プログラムドライバーパッケージの作成」を参照してください

特定のデバイススタックにプラグインするバイナリを提供する場合は、プラグインしている特定のデバイススタックのドキュメントを参照して、バイナリへの完全なファイルパスの提供をサポートしているかどうか、およびその完全なファイルパスに制限があるかどうかを確認してください。。バイナリへの完全ファイルパスの提供をそのパスの制限なしでサポートしている場合は、'ドライバーストアから実行' されるファイルをサポートする必要があります。

ドライバーストアから動的にファイルを見つけて読み込む

場合によっては、コンポーネントが「ドライバーストアから実行」を使用するドライバーパッケージの一部であるファイルを読み込む必要があることがあります。これらのドライバーパッケージファイルへのパスは、ドライバーパッケージのバージョン、OS バージョン、OS エディションなどによって異なる可能性があるため、ハードコーディングしないでください。ドライバーパッケージファイルを読み込む必要が生じた場合は、これらのドライバーパッケージファイルをハードコーディングする必要があります。以下で説明するパラダイムのいくつかを使用して、動的に検出およびロードできます。

同じドライバーパッケージ内のファイルを検索して読み込む

ドライバーパッケージ内のファイルが、同じドライバーパッケージから別のファイルを読み込む必要がある場合、そのファイルを動的に検出するためのオプションの 1 つは、このファイルが実行されているディレクトリを特定し、そのディレクトリから見て相対的に他のファイルを読み込むことです。

Windows 10 バージョン 1803 以降のドライバーストアから実行され、ドライバーパッケージから他のファイルにアクセスする必要がある WDM または KMDFドライバーは、ドライバーの読み込み元のディレクトリパスを取得するために、ディレクトリタイプとして DriverDirectoryImage を指定して IoGetDriverDirectory を呼び出す必要があります。または、Windows 10 バージョン 1803 より前の OS バージョンをサポートする必要があるドライバーの場合は、 IoQueryFullDriverPath を使用してドライバーのパスを見つけ、読み込み元であるディレクトリパスを取得して、そのパスから見て相対的な場所にあるファイルを探します。カーネルモードドライバーが KMDF ドライバーの場合、 WdfDriverWdmGetDriverObject を使用して、IoQueryFullDriverPath に渡す WDM ドライバーオブジェクトを取得できます。

ユーザーモードバイナリは、 GetModuleHandleExW と GetModuleFileNameW を使用して、バイナリが読み込まれた場所を特定できます。たとえば、UMDF ドライバーバイナリは、次のような処理を実行できます。

bRet = GetModuleHandleExW(GET_MODULE_HANDLE_EX_FLAG_FROM_ADDRESS,
                         (PCWSTR)&DriverEntry,
                         &handleModule);
if (bRet) {
    charsWritten = GetModuleFileNameW(handleModule,
                                      path,
                                      pathLength);
    …

任意のドライバーパッケージのファイルを検索して読み込む

ドライバーパッケージには、別のドライバーパッケージのバイナリまたはユーザーモードコンポーネントによって読み込まれるファイルが含まれている場合があります。同じドライバーパッケージからのファイルの読み込みについて前述した方法よりも優先される場合は、この方法を同じドライバーパッケージのファイルに対して使用することもできます。

次に、ドライバーパッケージからのファイルの読み込みに関連する可能性のあるシナリオの例をいくつか示します。

ドライバーパッケージ内のユーザーモード DLL が、ドライバーパッケージ内のドライバーと通信するためのインターフェイスを提供する。
拡張ドライバーパッケージに、ベースドライバーパッケージ内のドライバーによって読み込まれる構成ファイルが含まれている。

このような状況では、ドライバーパッケージは、読み込まれると予期されるファイルのパスを示すデバイスまたはデバイスインターフェイスに対して、状態を設定する必要があります。

ドライバーパッケージは通常、HKR AddReg を使用してこの状態を設定できます。この例では、 ExampleFile.dll について、ドライバーパッケージは subdir のない SourceDisksFiles エントリを持つとします。この結果、このファイルはドライバーパッケージディレクトリの root に存在します。また、 CopyFiles ディレクティブの DestinationDirs に dirid 13 が指定されることを前提とする必要があります。

これをデバイス状態として設定するINFの例を次に示します。

[ExampleDDInstall.HW]
AddReg = Example_DDInstall.AddReg

[Example_DDInstall.AddReg]
HKR,,ExampleValue,,%13%\ExampleFile.dll

デバイスインターフェイスの状態としてこれを設定する INF の例は次のようになります。

[ExampleDDInstall.Interfaces]
AddInterface = {<fill in an interface class GUID for an interface exposed by the device>},,Example_Add_Interface_Section

[Example_Add_Interface_Section]
AddReg = Example_Add_Interface_Section.AddReg

[Example_Add_Interface_Section.AddReg]
HKR,,ExampleValue,,%13%\ExampleFile.dll

前の例では、空のフラグ値が使用されているため、REG_SZ レジストリ値になります。これにより、 %13% が完全修飾ユーザーモードファイルパスに変換されます。多くの場合、パスは環境変数に対する相対パスであることが望ましいです。フラグ値 0x20000 を使用すると、レジストリ値はタイプ REG_EXPAND_SZ となり、 %13% は適切な環境変数で変換され、パスの場所が抽象化されます。このレジストリ値を取得する場合、 ExpandEnvironmentStrings を呼び出して、パスの環境変数を解決します。

カーネルモードコンポーネントによってこの値を読み取る必要がある場合、値は REG_SZ 値でなければなりません。カーネルモードコンポーネントはこの値を読み取るときに、先頭に \??\ を付けてから、 ZwOpenFile などの API に渡す必要があります。

この設定がデバイスの状態の一部である場合にこの設定にアクセスするには、まずアプリケーションがデバイスのIDを見つける必要があります。ユーザーモードコードでは、 CM_Get_Device_ID_List_Size および CM_Get_Device_ID_List を使用してデバイスの一覧 (必要に応じて、フィルタ適用) を取得できます。このデバイスの一覧には複数のデバイスが含まれている場合があるため、デバイスから状態を読み取る前に、適切なデバイスを検索します。たとえば、特定の条件に一致するデバイスを検索するときに、CM_Get_DevNode_Property を呼び出して、そのデバイスのプロパティを取得します。

適切なデバイスが見つかったら、 CM_Open_DevNode_Key を呼び出して、デバイスの状態が格納されたレジストリの場所へのハンドルを取得します。

カーネルモードコードでは、デバイスに対して PDO (物理デバイスオブジェクト) を状態とともに取得し、 IoOpenDeviceRegistryKey を呼び出す必要があります。カーネルモードコードでデバイスの PDO を取得する方法の 1 つとして、デバイスによって公開されている有効なインターフェイスを検出し、 IoGetDeviceObjectPointer を使用してデバイスオブジェクトを取得する方法があります。

デバイスインターフェイス状態のときにこの設定にアクセスするには、ユーザーモードコードで CM_Get_Device_Interface_List_Size および CM_Get_Device_Interface_Listを呼び出すことができます。

また、デバイスインターフェイスの接続や削除の通知を受けるために、 CM_Register_Notification を使用できます。これにより、コードではインターフェイスが有効化されたときに通知を受け、状態を取得できます。上記の API で使用されるデバイスインターフェイスクラスには、複数のデバイスインターフェイスがある可能性があります。これらのインターフェイスを確認し、設定を読み込むために適切なインターフェイスを特定します。

適切なインターフェイスが見つかったら、 CM_Open_Device_Interface_Key を呼び出します。

カーネルモードコードでは、状態を取得するデバイスインターフェイスのシンボリックリンク名を取得できます。そのためには、 IoRegisterPlugPlayNotification を呼び出して、適切なデバイスインターフェイスクラスでデバイスインターフェイス通知に登録します。別の方法として、システム上の現在のデバイスインターフェイスの一覧を取得するために IoGetDeviceInterfaces を呼び出すこともできます。上記の API で使用されるデバイスインターフェイスクラスには、複数のデバイスインターフェイスがある可能性があります。これらのインターフェイスを確認し、設定を読み取る適切なインターフェイスを特定します。

適切なシンボリックリンク名が見つかったら、 IoOpenDeviceInterfaceRegistryKey を呼び出して、デバイスインターフェイスの状態が格納されたレジストリの場所へのハンドルを取得します。

Note

CM_GETIDLIST_FILTER_PRESENT フラグと CM_Get_Device_ID_List_Size および CM_Get_Device_ID_List を使用するか、 CM_GET_DEVICE_INTERFACE_LIST_PRESENT フラグと CM_Get_Device_Interface_List_Size および CM_Get_Device_Interface_List を使用します。これにより、ファイルパスを含む状態に関連するハードウェアが存在し、通信の準備ができていることが確認されます。

ドライバーパッケージの削除

デフォルトでは、ドライバーパッケージがデバイスにまだインストールされている場合、そのドライバーパッケージをシステムから削除することはできません。ただし、システムからドライバーパッケージを削除するための一部のオプションでは、"強制的" な削除を試行できます。これにより、ドライバーパッケージがシステムの一部のデバイスにまだインストールされている場合でも、ドライバーパッケージの削除が試行されます。「ドライバーストアから実行」されるファイルを含むドライバーパッケージの強制削除は許可されません。ドライバーパッケージがシステムから削除されると、そのドライバーストアの内容は削除されます。そのドライバーパッケージを使用してインストールされているデバイスがある場合は、そのドライバーパッケージ内の "ドライバーストアから実行する" ファイルがすべて削除され、それらの欠落しているファイルが原因でデバイスが誤動作する可能性があります。デバイスがそのような悪い状態に陥るのを防ぐために、「ドライバーストアから実行」ファイルを含むドライバーパッケージは強制的に削除できません。これらは、どのデバイスにもインストールされなくなった場合にのみ削除できます。このようなドライバーパッケージの削除を支援するために、 DiUninstallDriver または pnputil /delete-driver <oem#.inf> /uninstall を使用できます。これらの削除方法では、ドライバーパッケージの削除を試行する前に、削除するドライバーパッケージを使用しているデバイスを更新して、そのドライバーパッケージが今後インストールされることのないようにします。

ドライバーパッケージの開発

プライベートバイナリのテスト

ドライバーパッケージを開発するときに、システム上のドライバーパッケージを完全に再構築して置き換えるのではなく、ドライバーパッケージの特定の実行可能ファイルをプライベートバージョンに置き換える必要がある場合は、カーネルデバッガーを .kdfiles コマンドとともに使用することを勧めます。ドライバーストア内のファイルへのフルパスはハードコーディングすべきではないため、.kdfiles マッピングでは、 OldDriver ファイル名は先行するパス情報のない単なるファイルの直接名であることが推奨されます。これ (および他のシナリオ) を容易にするために、ドライバーパッケージ内のファイル名はできる限り一意にして、システム上の無関係なドライバーパッケージのファイル名と一致しないようにする必要があります。

ドライバーストアからの実行を使用するように INF を移植する

ドライバーストアからの実行を使用しない INF を含む既存のドライバーパッケージがあり、それをドライバーストアからの実行を使用するように移植する場合、次の例は、INFでの一般的なファイルの使用法と、それらのファイルを実行するように更新するパターンを示しています。ドライバーストア。

宛先ディレクトリの更新に関するクイックリファレンス

次の表は、ドライバーパッケージ INFがファイルに対して指定する現在の宛先ディレクトリ DIRID に基づいて、適切なガイダンスを見つけるためのクイックリファレンスを提供します。

ディリド	Subdirectory	詳細
13		ファイルはすでに「ドライバーストアから実行」を使用しています。これ以上の作業は必要ありません。
1		DIRID 1は使用しないでください。ファイルへの参照を解決する必要があるときに、ソースディレクトリが使用できるという保証はありません。その代わりに、ドライバーパッケージ内のコンポーネントが特定のファイルに依存している場合は、それらのファイルをドライバーパッケージに含めて、ドライバーストアから実行します。
10	ファームウェア	DIRID 13をファームウェア更新ドライバーパッケージとともに使用して「ドライバーストアから実行」を使用する方法については、更新ドライバーパッケージの作成を参照。
10		他のファイルを参照。
11		他のファイルを参照。
12	UMDF	UMDF ドライバーバイナリを参照。
12		DIRID 12の宛先を持つほとんどのファイルは、ドライバーサービスバイナリを表します。サービスバイナリを参照。
16422、16426、16427、16428		これらの DIRID の宛先を持つほとんどのファイルは、アプリケーションのインストールを表します。代わりに、ユニバーサルウィンドウプラットフォーム (UWP) アプリケーションを提供し、ドライバーパッケージ INFの DDInstall.Software セクションから AddSoftware ディレクティブを使用してインストールします。詳細については、ドライバーとユニバーサルウィンドウプラットフォーム (UWP) アプリの組み合わせを参照。

サービスバイナリ

INFがサービスを追加し、バイナリがドライバーストアから実行されていない場合、INFは次のようになります。

[DestinationDirs]
 ; Copy the file to %windir%\system32\drivers
 Example_CopyFiles = 12

[ExampleDDInstall]
CopyFiles = Example_CopyFiles

[Example_CopyFiles]
ExampleBinary.sys

[ExampleDDInstall.Services]
AddService = ExampleService,0x2,Example_Service_Inst

[Example_Service_Inst]
DisplayName   = %SvcDesc%
ServiceType   = %SERVICE_KERNEL_DRIVER%
StartType     = %SERVICE_DEMAND_START%
ErrorControl  = %SERVICE_ERROR_NORMAL%
; Point at the file in %windir%\system32\drivers
ServiceBinary = %12%\ExampleBinary.sys

このファイルをドライバーストアから実行されるように移動するには、ファイルのコピー先の DestinationDirs エントリを更新し、このファイルの場所を参照する ServiceBinary ディレクティブを更新する必要があります。

[DestinationDirs]
; Update the destination to DIRID 13
Example_CopyFiles = 13

[ExampleDDInstall]
CopyFiles = Example_CopyFiles

[Example_CopyFiles]
ExampleBinary.sys

[ExampleDDInstall.Services]
AddService = ExampleService,0x2,Example_Service_Inst

[Example_Service_Inst]
DisplayName   = %SvcDesc%
ServiceType   = %SERVICE_KERNEL_DRIVER%
StartType     = %SERVICE_DEMAND_START%
ErrorControl  = %SERVICE_ERROR_NORMAL%
; Point at the run from Driver Store file using DIRID 13
ServiceBinary = %13%\ExampleBinary.sys

UMDF ドライバーバイナリ

INFがUMDFドライバーを追加し、バイナリがドライバーストアから実行されていない場合、INF は次のようになります。

[DestinationDirs]
; Copy the file to %windir%\system32\drivers\UMDF
Example_CopyFiles = 12, UMDF

[ExampleDDInstall]
CopyFiles = Example_CopyFiles

[Example_CopyFiles]
ExampleUmdfDriver.dll

[ExampleDDInstall.Wdf]
UmdfService = ExampleUmdfDriver,Example_UMDF_Inst
...

[Example_UMDF_Inst]
; Point at the file in %windir%\system32\drivers\UMDF
ServiceBinary = %12%\UMDF\ExampleUmdfDriver.dll
...

[DestinationDirs]
; Update the destination to DIRID 13
Example_CopyFiles = 13

[ExampleDDInstall]
CopyFiles = Example_CopyFiles

[Example_CopyFiles]
ExampleUmdfDriver.dll

[ExampleDDInstall.Wdf]
UmdfService = ExampleUmdfDriver,Example_UMDF_Inst
...

[Example_UMDF_Inst]
; Point at the run from Driver Store file using DIRID 13
ServiceBinary = %13%\ExampleUmdfDriver.dll
...

他のファイル

他のコンポーネントによって読み込まれる可能性があり、ドライバーストアから実行されないファイルを INF に追加する場合、INFは次のようになります。この例では、ファイルの名前のみがデバイスのレジストリの状態に書き込まれます。このレジストリ値を読み取って、読み込むファイルを決定するコンポーネントは、ファイルが %windir%\system32 にあるか、または LoadLibraryの検索順序に応じてファイルを見つけることができます。

[DestinationDirs]
; Copy the file to %windir%\system32
Example_CopyFiles = 11

[ExampleDDInstall]
CopyFiles=Example_CopyFiles
AddReg=Example_AddReg

[Example_CopyFiles]
ExampleFile.dll

[Example_AddReg]
HKR,,FileLocation,,"ExampleFile.dll"

このファイルをドライバーストアから実行されるように移動するには、ファイルのコピー先の DestinationDirs エントリを更新し、デバイスの状態に保存されている場所を更新する必要があります。そのためには、そのレジストリ値を読み取るコンポーネントが、 %windir%\system32への相対パスではなく、ファイルへの完全パスであるレジストリ値を処理できるようにする必要があります。

[DestinationDirs]
Example_CopyFiles = 13 ; update the destination to DIRID 13

[ExampleDDInstall]
CopyFiles=Example_CopyFiles
AddReg=Example_AddReg

[Example_CopyFiles]
ExampleFile.dll

[Example_AddReg]
; Point at the run from Driver Store file using DIRID 13
HKR,,FileLocation,,"%13%\ExampleFile.dll"

次の方法で共有

ドライバーストアから実行する

ドライバーストアから動的にファイルを見つけて読み込む

同じドライバーパッケージ内のファイルを検索して読み込む

任意のドライバーパッケージのファイルを検索して読み込む

ドライバーパッケージの削除

ドライバーパッケージの開発

プライベートバイナリのテスト

ドライバーストアからの実行を使用するように INF を移植する

宛先ディレクトリの更新に関するクイックリファレンス

サービスバイナリ

UMDF ドライバーバイナリ

他のファイル

フィードバック

その他のリソース

次の方法で共有

ドライバー ストアから実行する

ドライバー ストアから動的にファイルを見つけて読み込む

同じドライバー パッケージ内のファイルを検索して読み込む

任意のドライバー パッケージのファイルを検索して読み込む

ドライバー パッケージの削除

ドライバー パッケージの開発

プライベート バイナリのテスト

ドライバー ストアからの実行を使用するように INF を移植する

宛先ディレクトリの更新に関するクイック リファレンス

サービス バイナリ

UMDF ドライバー バイナリ

他のファイル

フィードバック

その他のリソース

ドライバーストアから実行する

ドライバーストアから動的にファイルを見つけて読み込む

同じドライバーパッケージ内のファイルを検索して読み込む

任意のドライバーパッケージのファイルを検索して読み込む

ドライバーパッケージの削除

ドライバーパッケージの開発

プライベートバイナリのテスト

ドライバーストアからの実行を使用するように INF を移植する

宛先ディレクトリの更新に関するクイックリファレンス

サービスバイナリ

UMDF ドライバーバイナリ