Funzione IoSetDeviceInterfacePropertyData (wdm.h)

Articolo
02/27/2024

La routine IoSetDeviceInterfacePropertyData modifica il valore corrente di una proprietà dell'interfaccia del 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 alla routine IoGetDeviceInterfaces, IoGetDeviceInterfaceAlias o 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. L'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 della lingua, vedere Struttura LCID.

[in] Flags

Impostare questo parametro su PLUGPLAY_PROPERTY_PERSISTENT se il valore della proprietà impostato da questa routine deve essere persistente 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 dei dati.

[in] Size

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

[in, optional] Data

Puntatore ai dati della proprietà dell'interfaccia del dispositivo. Impostare questo parametro su NULL per eliminare la proprietà specificata. Se Data è diverso da NULL, la routine archivia una copia interna del valore della proprietà. Il buffer a cui punta dati 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.

Commenti

I driver in modalità kernel usano la routine IoSetDeviceInterfacePropertyData per modificare le proprietà dell'interfaccia del dispositivo definite come parte del modello di proprietà del dispositivo unificato. Per altre informazioni sulle proprietà dell'interfaccia del dispositivo, vedere Proprietà del 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 in esecuzione in IRQL <= APC_LEVEL nel contesto di un thread di sistema.

Requisiti

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

Vedi anche

DEVPROPKEY

DEVPROPTYPE

IoGetDeviceInterfacePropertyData

Condividi tramite