SP_DRVINFO_DATA_V2_A構造体 (setupapi.h)
SP_DRVINFO_DATA構造体には、ドライバーに関する情報が含まれています。 この構造体は、ドライバー情報リストのメンバーであり、特定のデバイス インスタンスに関連付けたり、デバイス情報セットにグローバルに関連付けたりすることができます。
構文
typedef struct _SP_DRVINFO_DATA_V2_A {
DWORD cbSize;
DWORD DriverType;
ULONG_PTR Reserved;
CHAR Description[LINE_LEN];
CHAR MfgName[LINE_LEN];
CHAR ProviderName[LINE_LEN];
FILETIME DriverDate;
DWORDLONG DriverVersion;
} SP_DRVINFO_DATA_V2_A, *PSP_DRVINFO_DATA_V2_A;
メンバー
cbSize
SP_DRVINFO_DATA構造体のサイズ (バイト単位)。 詳細については、このトピックの「解説」セクションを参照してください。
DriverType
この構造体で表されるドライバーの種類。 次のいずれかの値を指定する必要があります。
SPDIT_CLASSDRIVER
この構造体は、クラス ドライバーを表します。
SPDIT_COMPATDRIVER
この構造体は、互換性のあるドライバーを表します。
Reserved
予約済み。 内部使用専用です。
Description[LINE_LEN]
このドライバーでサポートされているデバイスを記述する NULL で終わる文字列。
MfgName[LINE_LEN]
このドライバーでサポートされているデバイスの製造元の名前を含む NULL で終わる文字列。
ProviderName[LINE_LEN]
このドライバーのプロバイダーを提供する NULL で終わる文字列。 これは通常、ドライバーまたは INF ファイルを作成するorganizationの名前です。 ProviderName には空の文字列を指定できます。
DriverDate
ドライバーの日付。 INF ファイルの DriverVer エントリから。 DriverVer エントリの詳細については、INF DDInstall セクションを参照してください。
DriverVersion
ドライバーのバージョン。 INF ファイルの DriverVer エントリから。
解説
SetupAPI.h では、この構造は、ソース コードに次の行を含めるかどうかに基づいて、SP_DRVINFO_DATA_V1またはSP_DRVINFO_DATA_V2に相当します。
#define USE_SP_DRVINFO_DATA_V1 1
この識別子は、コンポーネントを Windows 98 または Millennium Edition、または Windows NT で実行する必要がある場合にのみ定義します。 コンポーネントが Windows 2000 以降のバージョンの Windows でのみ実行される場合は、識別子を定義しないでください。 識別子が定義されていない場合は、SP_DRVINFO_DATA_V2が使用されます。
SP_DRVINFO_DATA_V1には 、DriverDate メンバーと DriverVersion メンバーは含まれません。
パラメーターとしてSP_DRVINFO_DATA構造体を受け取る SetupDiXxx 関数は、指定された構造体の cbSize メンバーが構造体のサイズ (バイト単位) と等しいことを確認します。 cbSize メンバーが入力パラメーターに対して正しく設定されていない場合、関数は失敗し、ERROR_INVALID_PARAMETERのエラー コードを設定します。 cbSize メンバーが出力パラメーターに正しく設定されていない場合、関数は失敗し、ERROR_INVALID_USER_BUFFERのエラー コードを設定します。
注意
setupapi.h ヘッダーは、SP_DRVINFO_DATA_V2をエイリアスとして定義します。これは、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択します。 エンコードに依存しないエイリアスをエンコードニュートラルでないコードと組み合わせて使用すると、コンパイルまたはランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「 関数プロトタイプの規則」を参照してください。
必要条件
| Header | setupapi.h (Setupapi.h を含む) |