IoSetDeviceInterfacePropertyData 函数 (wdm.h)
IoSetDeviceInterfacePropertyData 例程修改 设备接口属性的当前值。
语法
NTSTATUS IoSetDeviceInterfacePropertyData(
[in] PUNICODE_STRING SymbolicLinkName,
[in] const DEVPROPKEY *PropertyKey,
[in] LCID Lcid,
[in] ULONG Flags,
[in] DEVPROPTYPE Type,
[in] ULONG Size,
[in, optional] PVOID Data
);
参数
[in] SymbolicLinkName
指向标识设备接口实例的字符串的指针。 此字符串是从先前调用 IoGetDeviceInterfaces、IoGetDeviceInterfaceAlias或 IoRegisterDeviceInterface 例程中获取的。
[in] PropertyKey
指向包含设备接口属性键的 DEVPROPKEY 结构的指针。
[in] Lcid
指定区域设置标识符。 将此参数设置为特定于语言的 LCID 值或 LOCALE_NEUTRAL。 LOCALE_NEUTRAL LCID 指定属性是非特定语言(即不特定于任何语言)。 不要将此参数设置为 LOCALE_SYSTEM_DEFAULT 或 LOCALE_USER_DEFAULT。 有关特定于语言的 LCID 值的详细信息,请参阅 LCID 结构。
[in] Flags
如果此例程设置的属性值应在计算机重启后持久保留,请将此参数设置为 PLUGPLAY_PROPERTY_PERSISTENT。 否则,请将 标志 设置为零。
[in] Type
将此参数设置为 DEVPROPTYPE 值,该值指定 数据 缓冲区中提供的数据的类型。
[in] Size
指定 数据 指向的缓冲区的大小(以字节为单位)。
[in, optional] Data
指向设备接口属性数据的指针。 将此参数设置为 NULL 以删除指定的属性。 如果 数据 为非NULL,则例程将存储属性值的内部副本。 Data 指向的缓冲区不需要在调用返回后保持有效。
返回值
IoSetDeviceInterfacePropertyData 如果调用成功,则返回STATUS_SUCCESS。 可能的错误返回值包括以下状态代码。
返回代码 | 描述 |
---|---|
STATUS_UNSUCCESSFUL | 指定的 LCID 值无效。 |
STATUS_NOT_IMPLEMENTED | 不支持指定的属性。 |
言论
内核模式驱动程序使用 IoSetDeviceInterfacePropertyData 例程来修改定义为 统一设备属性模型的一部分的设备接口属性。 有关设备接口属性的详细信息,请参阅 设备属性。
驱动程序可以使用 IoGetDeviceInterfacePropertyData 例程获取设备接口属性的当前值。
IoSetDeviceInterfacePropertyData 的调用方必须在 IRQL <= 系统线程上下文中APC_LEVEL运行。
要求
要求 | 价值 |
---|---|
最低支持的客户端 | 适用于 Windows 8 及更高版本的 Windows。 |
目标平台 | 普遍 |
标头 | wdm.h (包括 Wdm.h、Ntddk.h、Ntifs.h) |
库 | NtosKrnl.lib |
DLL | NtosKrnl.exe |
IRQL | <= APC_LEVEL |