Функция 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, чтобы удалить указанное свойство. Если data неNULL, подпрограмма сохраняет внутреннюю копию значения свойства. Буфер, на который указывает Data, не требуется оставаться действительным после возврата вызова.

Возвращаемое значение

IoSetDeviceInterfacePropertyData возвращает STATUS_SUCCESS, если вызов выполнен успешно. Возможные значения возвращаемых ошибок включают следующие коды состояния.

Замечания

Драйверы режима ядра используют подпрограмму IoSetDeviceInterfacePropertyData для изменения свойств интерфейса устройства, определенных в рамках модели унифицированных свойств устройства. Дополнительные сведения о свойствах интерфейса устройства см. в свойств устройства.

Драйверы могут использовать подпрограмму IoGetDeviceInterfacePropertyData для получения текущего значения для свойства интерфейса устройства.

Вызывающие IoSetDeviceInterfacePropertyData должны выполняться в IRQL <= APC_LEVEL в контексте системного потока.

Требования

См. также

DEVPROPKEY

DEVPROPTYPE

IoGetDeviceInterfacePropertyData