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 で導入) |