DismGetDrivers 函数
列出映像中的驱动程序。
语法
HRESULT WINAPI DismGetDrivers(
_In_ DismSession Session,
_In_ BOOL AllDrivers,
_Out_ DismDriverPackage **DriverPackage,
_Out_ UINT *Count
);
参数
Session [in]
一个有效的 DismSession。 DismSession 必须关联一个映像。 可以使用 DismOpenSession 将会话与映像关联。
AllDrivers [in]
指定要检索的驱动程序的布尔值。
| 值 | 说明 |
|---|---|
| TRUE | 检索所有驱动程序。 |
| FALSE | 仅检索开箱即用驱动程序。 即装即用驱动程序是最初未包含在 Windows 映像中的驱动程序。 |
DriverPackage [out]
指向 DismDriverPackage 结构数组地址的指针。
计数 [out]
返回的 DismDriverPackage 结构的数量。
返回值
成功时返回 S_OK 。
示例
HRESULT hr = S_OK;
DismDriver* DriverPackageInfos;
UINT Count;
hr = DismGetDrivers(Session, TRUE, &DriverPackageInfos, &Count);
要求
| 要求 | 说明 |
|---|---|
| 支持的主机平台 | DISM API 可在 Windows 评估和部署工具包 (Windows ADK) 支持的任何操作系统上使用。 有关详细信息，请参阅 Windows ADK 技术参考。 |
| 支持的映像平台 | Windows 7、Windows Server 2008 R2、Windows PE 3.0、Windows 8、Windows Server 2012、Windows 预安装环境 (Windows PE) 4.0、Windows 8.1、Windows Server 2012 R2、Windows 10、Windows Server 2016 |
| 最低受支持的客户端 | Windows 7 [仅限桌面应用] |
| 最低受支持的服务器 | Windows Server 2008 R2 [仅限桌面应用] |
| 标头 | DismAPI.h |
| Library | DismAPI.lib |
| DLL | DismAPI.dll |