Funzione WdfRegistryAssignValue (wdfregistry.h)

Articolo
03/22/2025

[Si applica a KMDF e UMDF]

Il metodo WdfRegistryAssignValue assegna i dati specificati a un nome di valore specificato nel Registro di sistema.

Sintassi

NTSTATUS WdfRegistryAssignValue(
  [in] WDFKEY           Key,
  [in] PCUNICODE_STRING ValueName,
  [in] ULONG            ValueType,
  [in] ULONG            ValueLength,
  [in] PVOID            Value
);

Parametri

[in] Key

Handle di un oggetto chiave del Registro di sistema che rappresenta una chiave del Registro di sistema aperta.

[in] ValueName

Puntatore a una struttura UNICODE_STRING che contiene un nome di valore.

[in] ValueType

Valore che identifica il tipo di dati. Per un elenco dei valori dei tipi di dati, vedere il membro tipo di di KEY_VALUE_BASIC_INFORMATION.

[in] ValueLength

Lunghezza, in byte, del buffer a cui valore punta.

[in] Value

Puntatore a un buffer contenente i dati forniti dal driver.

Valore restituito

WdfRegistryAssignValue restituisce STATUS_SUCCESS se l'operazione ha esito positivo. In caso contrario, il metodo potrebbe restituire uno dei valori seguenti:

Codice restituito	Descrizione
STATUS_INVALID_DEVICE_REQUEST	WdfRegistryAssignValue non è stato chiamato in IRQL = PASSIVE_LEVEL.
STATUS_INVALID_PARAMETER	È stato specificato un parametro non valido.
STATUS_ACCESS_DENIED	Il driver non ha aperto la chiave del Registro di sistema con accesso KEY_SET_VALUE.

Questo metodo potrebbe anche restituire altri valori NTSTATUS .

Se il driver fornisce un handle di oggetto non valido, si verifica un controllo di bug.

Osservazioni:

Se il nome del valore specificato dal parametro valueName esiste già, WdfRegistryAssignValue aggiorna i dati del valore.

Per altre informazioni sugli oggetti chiave del Registro di sistema, vedere Using the Registry in Framework-Based Drivers.

Esempi

L'esempio di codice seguente assegna 123456 esadecimali a un valore del Registro di sistema come dati binari.

ULONG val;
NTSTATUS status;

val = 0x123456;
status = WdfRegistryAssignValue(
                                Key,
                                &valueName,
                                REG_BINARY,
                                sizeof(val),
                                &val
                                );

Requisiti

Requisito	Valore
Piattaforma di destinazione	Universale
versione minima di KMDF	1.0
versione minima di UMDF	2.0
intestazione	wdfregistry.h (include Wdf.h)
Biblioteca	Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL	PASSIVE_LEVEL
regole di conformità DDI	DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)