次の方法で共有


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 ファイルを作成する組織の名前です。 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構造体を受け取る Xxx 関数SetupDi 、指定された構造体の cbSize メンバーが構造体のサイズ (バイト単位) と等しいことを確認します。 cbSize メンバーが入力パラメーターに対して正しく設定されていない場合、関数は失敗し、ERROR_INVALID_PARAMETERのエラー コードを設定します。 cbSize メンバーが出力パラメーターに正しく設定されていない場合、関数は失敗し、ERROR_INVALID_USER_BUFFERのエラー コードを設定します。

手記

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

必要条件

要件 価値
ヘッダー setupapi.h (Setupapi.h を含む)

関連項目

SetupDiEnumDriverInfo の

SetupDiGetDriverInstallParams の

SetupDiGetSelectedDriver の

SetupDiSetDriverInstallParams の

SetupDiSetSelectedDriver の