Funzione WdfRegistryAssignValue (wdfregistry.h)

Articolo
08/08/2023

[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 per 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 di valori del tipo di dati, vedere Il membro Type di KEY_VALUE_BASIC_INFORMATION.

[in] ValueLength

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

[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.

Commenti

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 Uso del Registro di sistema nei driver Framework-Based.

Esempio

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 KMDF minima	1,0
Versione UMDF minima	2,0
Intestazione	wdfregistry.h (include Wdf.h)
Libreria	Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL	PASSIVE_LEVEL
Regole di conformità DDI	DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)