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 を含む)

関連項目

SetupDiEnumDriverInfo

SetupDiGetDriverInstallParams

SetupDiGetSelectedDriver

SetupDiSetDriverInstallParams

SetupDiSetSelectedDriver