Funzione WdfDeviceAssignProperty (wdfdevice.h)

[Si applica a KMDF e UMDF]

Il metodo WdfDeviceAssignProperty modifica l'impostazione corrente di una proprietà del dispositivo.

Sintassi

NTSTATUS WdfDeviceAssignProperty(
  [in]           WDFDEVICE                 Device,
  [in]           PWDF_DEVICE_PROPERTY_DATA DeviceProperty,
  [in]           DEVPROPTYPE               Type,
  [in]           ULONG                     Size,
  [in, optional] PVOID                     Data
);

Parametri

[in] Device

Handle per un oggetto dispositivo framework.

[in] DeviceProperty

Puntatore a una struttura WDF_DEVICE_PROPERTY_DATA che identifica la proprietà del dispositivo da modificare.

[in] Type

Variabile DEVPROPTYPEtipizzata che specifica il tipo di dati archiviati in Data.

[in] Size

Dimensione, in byte, del buffer a cui punta Dati.

[in, optional] Data

Puntatore a un buffer allocato dal chiamante che contiene i dati della proprietà del dispositivo. Impostare questo parametro su NULL per eliminare la proprietà specificata.

Valore restituito

Se l'operazione ha esito positivo, WdfDeviceAssignProperty restituisce STATUS_SUCCESS. I valori restituiti aggiuntivi includono:

Codice restituito	Descrizione
STATUS_INVALID_PARAMETER	Uno dei parametri non è corretto.

 

Il metodo potrebbe restituire altri valori NTSTATUS .

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

Osservazioni

È possibile usare WdfDeviceAssignProperty per modificare l'impostazione di qualsiasi proprietà esposta tramite il modello di proprietà unificato.

Per informazioni sui metodi correlati, vedere Accesso al modello di proprietà del dispositivo unificato.

Fabbisogno

Requisito	Valore
piattaforma di destinazione	Universale
versione minima di KMDF	1.13
versione minima di UMDF	2.0
intestazione	wdfdevice.h (include Wdf.h)
libreria	Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL	APC_LEVEL

Vedere anche

WdfDeviceAssignInterfaceProperty