SetupDiDestroyDriverInfoList 関数 (setupapi.h)

  • [アーティクル]

SetupDiDestroyDriverInfoList 関数は、ドライバーの一覧を削除します。

構文

WINSETUPAPI BOOL SetupDiDestroyDriverInfoList(
  [in]           HDEVINFO         DeviceInfoSet,
  [in, optional] PSP_DEVINFO_DATA DeviceInfoData,
  [in]           DWORD            DriverType
);

パラメーター

[in] DeviceInfoSet

削除するドライバーリストを含む デバイス情報セット へのハンドル。

[in, optional] DeviceInfoData

DeviceInfoSet のデバイス情報要素を指定するSP_DEVINFO_DATA構造体へのポインター。 このパラメーターは省略可能であり、 NULL に設定できます。 このパラメーターを指定すると、 SetupDiDestroyDriverInfoList によって、指定したデバイスのドライバー リストが削除されます。 このパラメーターが NULL の場合、 SetupDiDestroyDriverInfoList は DeviceInfoSet に関連付けられているグローバル クラス ドライバー リストを削除します。

[in] DriverType

削除するドライバー リストの種類。これは、次のいずれかの値である必要があります。

SPDIT_CLASSDRIVER

クラス ドライバーの一覧を削除します。 DeviceInfoData が NULL の場合、このドライバー リストの種類を指定する必要があります。

SPDIT_COMPATDRIVER

指定したデバイスの互換性のあるドライバーの一覧を削除します。 このドライバー リストの種類が指定されている場合は、DeviceInfoData を指定する必要があります。

戻り値

成功した場合、関数は TRUE を 返します。 それ以外の場合は FALSE を 返し、ログに記録されたエラーを GetLastError の呼び出しで取得できます。

注釈

現在選択されているドライバーが削除されるリストのメンバーである場合、選択内容はリセットされます。

クラス ドライバーの一覧が削除されている場合は、対応するデバイス情報セットまたはデバイス情報要素のDI_FLAGSEX_DIDINFOLISTフラグとDI_DIDCLASS フラグがリセットされます。 DI_MULTMFGS フラグもリセットされます。

互換性のあるドライバー リストが破棄されている場合は、対応するデバイス情報要素のDI_FLAGSEX_DIDCOMPATINFOフラグとDI_DIDCOMPAT フラグがリセットされます。

要件

要件 値
サポートされている最小のクライアント Microsoft Windows 2000 以降のバージョンの Windows で使用できます。
対象プラットフォーム デスクトップ
Header setupapi.h (Setupapi.h を含む)
Library Setupapi.lib
[DLL] Setupapi.dll
API セット ext-ms-win-setupapi-classinstallers-l1-1-2 (Windows 10 バージョン 10.0.14393 で導入)

こちらもご覧ください

SetupDiBuildDriverInfoList