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 tipizzata DEVPROPTYPE che specifica il tipo di dati archiviati in Dati.
[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 |
---|---|
|
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.
Commenti
È possibile usare WdfDeviceAssignProperty per modificare l'impostazione di qualsiasi proprietà esposta tramite il modello di proprietà unificata.
Per informazioni sui metodi correlati, vedere Accesso al modello di proprietà del dispositivo unificato.
Requisiti
Requisito | Valore |
---|---|
Piattaforma di destinazione | Universale |
Versione KMDF minima | 1.13 |
Versione UMDF minima | 2,0 |
Intestazione | wdfdevice.h (include Wdf.h) |
Libreria | Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF) |
IRQL | APC_LEVEL |