SetupGetInfDriverStoreLocationA 関数 (setupapi.h)

[アーティクル]
11/20/2024

SetupGetInfDriverStoreLocation 関数は、システム INF ファイルディレクトリ内の指定された INF ファイルまたはドライバーストア内の指定された INF ファイルに対応する、ドライバーストアに INF ファイルの完全修飾ファイル名 (ディレクトリパスとファイル名) を取得します。

構文

WINSETUPAPI BOOL SetupGetInfDriverStoreLocationA(
  [in]            PCSTR                FileName,
  [in, optional]  PSP_ALTPLATFORM_INFO AlternatePlatformInfo,
  [in, optional]  PCSTR                LocaleName,
  [out]           PSTR                 ReturnBuffer,
  [in]            DWORD                ReturnBufferSize,
  [out, optional] PDWORD               RequiredSize
);

パラメーター

[in] FileName

システム INF ファイルディレクトリ内の INF ファイルの名前と、必要に応じて完全なディレクトリパスを含む NULL で終わる文字列へのポインター。または、このパラメーターは、ドライバーストア内の INF ファイルの完全修飾ファイル名 (ディレクトリパスとファイル名) を含む NULL で終わる文字列へのポインターです。

INF ファイルを指定する方法の詳細については、次の解説セクションを参照してください。

[in, optional] AlternatePlatformInfo

システム用に予約されています。

[in, optional] LocaleName

システム用に予約されています。

[out] ReturnBuffer

指定した INF ファイルの完全修飾ファイル名を含む NULL で終わる文字列を関数が返すバッファーへのポインター。このパラメーターは、NULL設定できます。サポートされているパスの最大サイズはMAX_PATH。バッファーの必要なサイズを決定する方法については、次の解説セクションを参照してください。

[in] ReturnBufferSize

ReturnBufferによって提供されるバッファーのサイズ (文字数)。

[out, optional] RequiredSize

ReturnBuffer バッファーのサイズを文字単位で受け取る DWORD 型の変数へのポインター。このパラメーターは省略可能であり、NULL設定できます。

戻り値

SetupGetInfDriverStoreLocation 成功した場合、関数は TRUE返します。それ以外の場合、関数は FALSE返します。拡張エラー情報を取得するには、GetLastError呼び出します。

null ターミネータを含む、要求された INF ファイルの完全修飾ファイル名のサイズが ReturnBufferSizeより大きい場合、関数は失敗し、GetLastError の呼び出しはERROR_INSUFFICIENT_BUFFERを返します。

備考

ドライバーストアに指定された INF ファイルの完全修飾ファイル名を格納するために必要な戻りバッファーのサイズを確認するには、SetupGetInfDriverStoreLocation 呼び出し、ReturnBuffer NULLをし、ReturnBufferSize を 0 にし、RequiredSize指定します。 SetupGetInfDriverStoreLocation は、RequiredSizeで必要なバッファーサイズ返します。

デバイスのインストールでは、ドライバーストアにドライバーパッケージがプレインストールされると、ドライバーパッケージ INF ファイルの 2 つのコピーが作成されます。デバイスのインストールでは、システム INF ディレクトリに 1 つのコピーをインストールし、その INF ファイルのコピーに、OEMnnn.inf形式の一意の発行済みファイル名を割り当てます。デバイスのインストールでは、ドライバーストアに INF ファイルの 2 番目のコピーをインストールし、元の INF ファイル名をコピーする割り当てます。

SetupGetInfDriverStoreLocation は、ドライバーストア内の INF ファイルの完全修飾ファイル名を返します。INF ファイルがある場合は、FileNameによって提供されます。 Filename では、システム INF ディレクトリ内の INF ファイルのファイル名と、必要に応じてディレクトリパスを指定する必要があります。または、ファイル名ドライバーストア内の INF ファイルの完全修飾ファイル名を指定する必要があります。

たとえば、ドライバーパッケージの INF ファイルが Myinf.infされ、このドライバーパッケージの場合はであるとします。デバイスのインストールでは、システム INF ディレクトリ C:\Windows\inf に OEM1.inf INF ファイルがインストールされます。さらに、デバイスのインストールでは、ドライバーストアに対応する INF ファイルコピー C:\windows\system32\driverstore\filerepository\myinf_12345678\myinf.inf がインストールされていることを前提としています。この場合、この関数は C:\windows\system32\driverstore\filerepository\myinf_12345678\myinf.infFileName が次のいずれかの文字列を提供する場合に返します OEM1.inf,C:\Windows\inf\OEM1.inf, または C:\windows\system32\driverstore\filerepository\myinf_12345678\myinf.inf.

クラスインストーラーと共同インストーラーは、SetupGetInfDriverStoreLocation を使用して、ドライバーストアにプレインストールされているドライバーパッケージ内のファイルにアクセスできます。ドライバーストア内のドライバーパッケージのパスを確認するために、インストーラーは次の処理を行います。

SetupDiGetDriverInfoDetail 呼び出して、ドライバーの SP_DRVINFO_DETAIL_DATA 構造を取得します。この構造体の InfFileName メンバーには、システム INF ディレクトリ内のドライバー INF ファイルの完全修飾ファイル名が含まれています。
SetupGetInfDriverStoreLocation 呼び出し、SetupDiGetDriverInfoDetail呼び出すことによって取得されたドライバー INF ファイルの完全修飾ファイル名を指定します。 SetupGetInfDriverStoreLocation は、ドライバーストア内のドライバー INF ファイルの完全修飾ファイル名を返します。 INF ファイルの完全修飾ファイル名のディレクトリパス部分は、ドライバーパッケージファイルのパスです。

注SetupGetInfDriverStoreLocation では、FileNameで指定された INF ファイルの内容処理されません。この関数を使用して、ドライバーストア内の INF ファイルのコンテンツ固有の検索を実行することはできません。

SetupGetInfPublishedName 関数を呼び出して、システム INF ファイルディレクトリ内の指定された INF ファイルまたはドライバーストア内の指定されたファイルに対応するシステム INF ファイルディレクトリに INF ファイルの完全修飾ファイル名を取得します。

手記

setupapi.h ヘッダーは、Unicode プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして SetupGetInfDriverStoreLocation を定義します。エンコードに依存しないエイリアスをエンコードに依存しないコードと組み合わせて使用すると、コンパイルエラーやランタイムエラーが発生する不一致が発生する可能性があります。詳細については、「関数プロトタイプの規則」を参照してください。

必要条件

要件	価値
サポートされる最小クライアント	Windows Vista 以降のバージョンの Windows で使用できます。
ターゲットプラットフォームの	デスクトップ
ヘッダー	setupapi.h (Setupapi.h を含む)
ライブラリ	Setupapi.lib

次の方法で共有

SetupGetInfDriverStoreLocationA 関数 (setupapi.h)

構文

パラメーター

戻り値

備考

必要条件

関連項目

フィードバック

その他のリソース