Funzione IoSetDeviceInterfacePropertyData (wdm.h)

Articolo
02/07/2025

La routine IoSetDeviceInterfacePropertyData modifica il valore corrente di una proprietà dell'interfaccia dispositivo .

Sintassi

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
);

Parametri

[in] SymbolicLinkName

Puntatore a una stringa che identifica l'istanza dell'interfaccia del dispositivo. Questa stringa è stata ottenuta da una chiamata precedente al IoGetDeviceInterfaces, IoGetDeviceInterfaceAliaso routine IoRegisterDeviceInterface.

[in] PropertyKey

Puntatore a una struttura DEVPROPKEY che contiene la chiave della proprietà dell'interfaccia del dispositivo.

[in] Lcid

Specifica un identificatore delle impostazioni locali. Impostare questo parametro su un valore LCID specifico della lingua o su LOCALE_NEUTRAL. Il LOCALE_NEUTRAL LCID specifica che la proprietà è indipendente dalla lingua, ovvero non specifica di alcuna lingua. Non impostare questo parametro su LOCALE_SYSTEM_DEFAULT o LOCALE_USER_DEFAULT. Per altre informazioni sui valori LCID specifici del linguaggio, vedere Struttura LCID.

[in] Flags

Impostare questo parametro su PLUGPLAY_PROPERTY_PERSISTENT se il valore della proprietà impostato da questa routine deve essere mantenuto tra i riavvii del computer. In caso contrario, impostare Flag su zero.

[in] Type

Impostare questo parametro sul valore DEVPROPTYPE che specifica il tipo di dati forniti nel buffer dati.

[in] Size

Specifica le dimensioni, in byte, del buffer a cui punta Data.

[in, optional] Data

Puntatore ai dati della proprietà dell'interfaccia dispositivo. Impostare questo parametro su NULL per eliminare la proprietà specificata. Se Data non ènull, la routine archivia una copia interna del valore della proprietà. Il buffer a cui punta Data non deve rimanere valido dopo la restituzione della chiamata.

Valore restituito

IoSetDeviceInterfacePropertyData restituisce STATUS_SUCCESS se la chiamata ha avuto esito positivo. I valori restituiti di errore possibili includono i codici di stato seguenti.

Codice restituito	Descrizione
STATUS_UNSUCCESSFUL	Il valore LCID specificato non è valido.
STATUS_NOT_IMPLEMENTED	La proprietà specificata non è supportata.

Osservazioni

I driver in modalità kernel usano la routine IoSetDeviceInterfacePropertyData per modificare le proprietà dell'interfaccia del dispositivo definite come parte del modello di proprietà unificata del dispositivo . Per altre informazioni sulle proprietà dell'interfaccia del dispositivo, vedere Proprietà dispositivo.

I driver possono usare la routine IoGetDeviceInterfacePropertyData per ottenere il valore corrente per una proprietà dell'interfaccia del dispositivo.

I chiamanti di IoSetDeviceInterfacePropertyData devono essere eseguiti in IRQL <= APC_LEVEL nel contesto di un thread di sistema.

Fabbisogno

Requisito	Valore
client minimo supportato	Disponibile per Windows 8 e versioni successive di Windows.
piattaforma di destinazione	Universale
intestazione	wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)
libreria	NtosKrnl.lib
dll	NtosKrnl.exe
IRQL	<= APC_LEVEL

Vedere anche

DEVPROPKEY

DEVPROPTYPE

IoGetDeviceInterfacePropertyData

Condividi tramite