ホーム › Devices.DeviceAndDriverInstallation › SetupGetInfDriverStoreLocationW

SetupGetInfDriverStoreLocationW

関数

ドライバーストア内のINFファイルの場所を取得する(Unicode)。

DLLSETUPAPI.dll文字セットUnicode (-W)呼出規約winapiSetLastErrorあり対応OSWindows Vista 以降

シグネチャ

// SETUPAPI.dll  (Unicode / -W)
#include <windows.h>

BOOL SetupGetInfDriverStoreLocationW(
    LPCWSTR FileName,
    SP_ALTPLATFORM_INFO_V2* AlternatePlatformInfo,   // optional
    LPCWSTR LocaleName,   // optional
    LPWSTR ReturnBuffer,
    DWORD ReturnBufferSize,
    DWORD* RequiredSize   // optional
);

パラメーター

名前	型	方向	説明
FileName	LPCWSTR	in	システムの INF ファイルディレクトリ内にある INF ファイルの名前 (省略可能で完全なディレクトリパスを含む) を格納した、NULL で終わる文字列へのポインター。あるいは、ドライバーストア内の INF ファイルの完全修飾ファイル名 (ディレクトリパスとファイル名) を格納した、NULL で終わる文字列へのポインターを指定します。 INF ファイルの指定方法の詳細については、後述の解説セクションを参照してください。
AlternatePlatformInfo	SP_ALTPLATFORM_INFO_V2*	inoptional	システムによる使用のために予約されています。
LocaleName	LPCWSTR	inoptional	システムによる使用のために予約されています。
ReturnBuffer	LPWSTR	out	指定した INF ファイルの完全修飾ファイル名を格納する、NULL で終わる文字列を関数が返すバッファーへのポインター。このパラメーターには NULL を設定できます。サポートされる最大のパスサイズは MAX_PATH です。バッファーに必要なサイズを判断する方法については、後述の解説セクションを参照してください。
ReturnBufferSize	DWORD	in	ReturnBuffer で指定されたバッファーのサイズ (文字数)。
RequiredSize	DWORD*	outoptional	ReturnBuffer バッファーのサイズ (文字数) を受け取る DWORD 型の変数へのポインター。このパラメーターは省略可能であり、NULL を設定できます。

戻り値の型: BOOL

公式ドキュメント

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

戻り値

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

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

解説(Remarks)

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

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

SetupGetInfDriverStoreLocation は、FileName で指定された INF ファイルに一致する INF ファイルがドライバーストア内に存在する場合、その完全修飾ファイル名を返します。Filename には、システムの INF ディレクトリ内にある INF ファイルのファイル名 (省略可能でディレクトリパスも) を指定する必要があります。あるいは、Filename にはドライバーストア内の INF ファイルの完全修飾ファイル名を指定する必要があります。

たとえば、あるドライバーパッケージの INF ファイルが Myinf.inf であり、このドライバーパッケージについて、デバイスのインストールがシステムの INF ディレクトリ C:\Windows\inf に INF ファイル OEM1.inf をインストールしたとします。さらに、デバイスのインストールが対応する INF ファイルのコピー C:\windows\system32\driverstore\filerepository\myinf_12345678\myinf.inf をドライバーストアにインストールしたとします。この場合、FileName に OEM1.inf、C:\Windows\inf\OEM1.inf、C:\windows\system32\driverstore\filerepository\myinf_12345678\myinf.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 ファイルを内容に基づいて検索することはできません。

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

メモ

setupapi.h ヘッダーは、SetupGetInfDriverStoreLocation を、UNICODE プリプロセッサ定数の定義に基づいてこの関数の ANSI 版または Unicode 版を自動的に選択するエイリアスとして定義しています。エンコーディング中立のエイリアスの使用を、エンコーディング中立でないコードと混在させると、不整合が生じ、コンパイルエラーまたは実行時エラーの原因となる可能性があります。詳細については、関数プロトタイプの規則を参照してください。

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)

各言語での呼び出し定義

// SETUPAPI.dll  (Unicode / -W)
#include <windows.h>

BOOL SetupGetInfDriverStoreLocationW(
    LPCWSTR FileName,
    SP_ALTPLATFORM_INFO_V2* AlternatePlatformInfo,   // optional
    LPCWSTR LocaleName,   // optional
    LPWSTR ReturnBuffer,
    DWORD ReturnBufferSize,
    DWORD* RequiredSize   // optional
);

[return: MarshalAs(UnmanagedType.Bool)]
[DllImport("SETUPAPI.dll", CharSet = CharSet.Unicode, SetLastError = true, ExactSpelling = true)]
static extern bool SetupGetInfDriverStoreLocationW(
    [MarshalAs(UnmanagedType.LPWStr)] string FileName,   // LPCWSTR
    IntPtr AlternatePlatformInfo,   // SP_ALTPLATFORM_INFO_V2* optional
    [MarshalAs(UnmanagedType.LPWStr)] string LocaleName,   // LPCWSTR optional
    [MarshalAs(UnmanagedType.LPWStr)] System.Text.StringBuilder ReturnBuffer,   // LPWSTR out
    uint ReturnBufferSize,   // DWORD
    IntPtr RequiredSize   // DWORD* optional, out
);

<DllImport("SETUPAPI.dll", CharSet:=CharSet.Unicode, SetLastError:=True, ExactSpelling:=True)>
Public Shared Function SetupGetInfDriverStoreLocationW(
    <MarshalAs(UnmanagedType.LPWStr)> FileName As String,   ' LPCWSTR
    AlternatePlatformInfo As IntPtr,   ' SP_ALTPLATFORM_INFO_V2* optional
    <MarshalAs(UnmanagedType.LPWStr)> LocaleName As String,   ' LPCWSTR optional
    <MarshalAs(UnmanagedType.LPWStr)> ReturnBuffer As System.Text.StringBuilder,   ' LPWSTR out
    ReturnBufferSize As UInteger,   ' DWORD
    RequiredSize As IntPtr   ' DWORD* optional, out
) As <MarshalAs(UnmanagedType.Bool)> Boolean
End Function

' FileName : LPCWSTR
' AlternatePlatformInfo : SP_ALTPLATFORM_INFO_V2* optional
' LocaleName : LPCWSTR optional
' ReturnBuffer : LPWSTR out
' ReturnBufferSize : DWORD
' RequiredSize : DWORD* optional, out
Declare PtrSafe Function SetupGetInfDriverStoreLocationW Lib "setupapi" ( _
    ByVal FileName As LongPtr, _
    ByVal AlternatePlatformInfo As LongPtr, _
    ByVal LocaleName As LongPtr, _
    ByVal ReturnBuffer As LongPtr, _
    ByVal ReturnBufferSize As Long, _
    ByVal RequiredSize As LongPtr) As Long
' Unicode(W): 文字列は ByVal As LongPtr とし StrPtr(unicodeStr) を渡す
' VBA7前提(PtrSafe)。32bit Office では LongPtr→Long。Integer=16bit / Long=32bit / LongLong=64bit。

import ctypes
from ctypes import wintypes

SetupGetInfDriverStoreLocationW = ctypes.windll.setupapi.SetupGetInfDriverStoreLocationW
SetupGetInfDriverStoreLocationW.restype = wintypes.BOOL
SetupGetInfDriverStoreLocationW.argtypes = [
    wintypes.LPCWSTR,  # FileName : LPCWSTR
    ctypes.c_void_p,  # AlternatePlatformInfo : SP_ALTPLATFORM_INFO_V2* optional
    wintypes.LPCWSTR,  # LocaleName : LPCWSTR optional
    wintypes.LPWSTR,  # ReturnBuffer : LPWSTR out
    wintypes.DWORD,  # ReturnBufferSize : DWORD
    ctypes.POINTER(wintypes.DWORD),  # RequiredSize : DWORD* optional, out
]
# GetLastError: use ctypes.GetLastError() (or ctypes.WinDLL(use_last_error=True))

require 'fiddle'
require 'fiddle/import'

lib = Fiddle.dlopen('SETUPAPI.dll')
SetupGetInfDriverStoreLocationW = Fiddle::Function.new(
  lib['SetupGetInfDriverStoreLocationW'],
  [
    Fiddle::TYPE_VOIDP,  # FileName : LPCWSTR
    Fiddle::TYPE_VOIDP,  # AlternatePlatformInfo : SP_ALTPLATFORM_INFO_V2* optional
    Fiddle::TYPE_VOIDP,  # LocaleName : LPCWSTR optional
    Fiddle::TYPE_VOIDP,  # ReturnBuffer : LPWSTR out
    -Fiddle::TYPE_INT,  # ReturnBufferSize : DWORD
    Fiddle::TYPE_VOIDP,  # RequiredSize : DWORD* optional, out
  ],
  Fiddle::TYPE_INT)
# Wide strings: pass str.encode("UTF-16LE") + "\x00\x00"

#[link(name = "setupapi")]
extern "system" {
    fn SetupGetInfDriverStoreLocationW(
        FileName: *const u16,  // LPCWSTR
        AlternatePlatformInfo: *mut SP_ALTPLATFORM_INFO_V2,  // SP_ALTPLATFORM_INFO_V2* optional
        LocaleName: *const u16,  // LPCWSTR optional
        ReturnBuffer: *mut u16,  // LPWSTR out
        ReturnBufferSize: u32,  // DWORD
        RequiredSize: *mut u32  // DWORD* optional, out
    ) -> i32;
}
// crates: windows-sys provides ready-made bindings for this API.

$sig = @"
[return: MarshalAs(UnmanagedType.Bool)]
[DllImport("SETUPAPI.dll", CharSet = CharSet.Unicode, SetLastError = true)]
public static extern bool SetupGetInfDriverStoreLocationW([MarshalAs(UnmanagedType.LPWStr)] string FileName, IntPtr AlternatePlatformInfo, [MarshalAs(UnmanagedType.LPWStr)] string LocaleName, [MarshalAs(UnmanagedType.LPWStr)] System.Text.StringBuilder ReturnBuffer, uint ReturnBufferSize, IntPtr RequiredSize);
"@
$api = Add-Type -MemberDefinition $sig -Name 'SETUPAPI_SetupGetInfDriverStoreLocationW' -Namespace Win32 -PassThru
# $api::SetupGetInfDriverStoreLocationW(FileName, AlternatePlatformInfo, LocaleName, ReturnBuffer, ReturnBufferSize, RequiredSize)

#uselib "SETUPAPI.dll"
#func global SetupGetInfDriverStoreLocationW "SetupGetInfDriverStoreLocationW" wptr, wptr, wptr, wptr, wptr, wptr
; SetupGetInfDriverStoreLocationW FileName, varptr(AlternatePlatformInfo), LocaleName, varptr(ReturnBuffer), ReturnBufferSize, varptr(RequiredSize)   ; 戻り値は stat
; FileName : LPCWSTR -> "wptr"
; AlternatePlatformInfo : SP_ALTPLATFORM_INFO_V2* optional -> "wptr"
; LocaleName : LPCWSTR optional -> "wptr"
; ReturnBuffer : LPWSTR out -> "wptr"
; ReturnBufferSize : DWORD -> "wptr"
; RequiredSize : DWORD* optional, out -> "wptr"
; ※HSP3.7は #func のため戻り値はシステム変数 stat に格納されます。

出力引数:

#uselib "SETUPAPI.dll"
#cfunc global SetupGetInfDriverStoreLocationW "SetupGetInfDriverStoreLocationW" wstr, var, wstr, var, int, var
; res = SetupGetInfDriverStoreLocationW(FileName, AlternatePlatformInfo, LocaleName, ReturnBuffer, ReturnBufferSize, RequiredSize)
; FileName : LPCWSTR -> "wstr"
; AlternatePlatformInfo : SP_ALTPLATFORM_INFO_V2* optional -> "var"
; LocaleName : LPCWSTR optional -> "wstr"
; ReturnBuffer : LPWSTR out -> "var"
; ReturnBufferSize : DWORD -> "int"
; RequiredSize : DWORD* optional, out -> "var"
; ※出力/バッファ引数は var 方式(変数を直接渡す)。varptr 方式にも切替可。#uselib "SETUPAPI.dll"
#cfunc global SetupGetInfDriverStoreLocationW "SetupGetInfDriverStoreLocationW" wstr, sptr, wstr, sptr, int, sptr
; res = SetupGetInfDriverStoreLocationW(FileName, varptr(AlternatePlatformInfo), LocaleName, varptr(ReturnBuffer), ReturnBufferSize, varptr(RequiredSize))
; FileName : LPCWSTR -> "wstr"
; AlternatePlatformInfo : SP_ALTPLATFORM_INFO_V2* optional -> "sptr"
; LocaleName : LPCWSTR optional -> "wstr"
; ReturnBuffer : LPWSTR out -> "sptr"
; ReturnBufferSize : DWORD -> "int"
; RequiredSize : DWORD* optional, out -> "sptr"
; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。