Función WdfDeviceAssignProperty (wdfdevice.h)
[Se aplica a KMDF y UMDF]
El método WdfDeviceAssignProperty modifica la configuración actual de una propiedad de dispositivo.
Sintaxis
NTSTATUS WdfDeviceAssignProperty(
[in] WDFDEVICE Device,
[in] PWDF_DEVICE_PROPERTY_DATA DeviceProperty,
[in] DEVPROPTYPE Type,
[in] ULONG Size,
[in, optional] PVOID Data
);
Parámetros
[in] Device
Identificador de un objeto de dispositivo de marco.
[in] DeviceProperty
Puntero a una estructura WDF_DEVICE_PROPERTY_DATA que identifica la propiedad del dispositivo que se va a modificar.
[in] Type
Variable con tipo DEVPROPTYPE que especifica el tipo de los datos almacenados en Datos.
[in] Size
Tamaño, en bytes, del búfer al que apunta Data.
[in, optional] Data
Puntero a un búfer asignado por el autor de la llamada que contiene los datos de propiedad del dispositivo. Establezca este parámetro en NULL para eliminar la propiedad especificada.
Valor devuelto
Si la operación se realiza correctamente, WdfDeviceAssignProperty devuelve STATUS_SUCCESS. Entre los valores devueltos adicionales se incluyen:
| Código devuelto | Descripción |
|---|---|
|
Uno de los parámetros es incorrecto. |
El método podría devolver otros valores NTSTATUS.
Se produce una comprobación de errores si el controlador proporciona un identificador de objeto no válido.
Comentarios
Puede usar WdfDeviceAssignProperty para modificar el valor de cualquier propiedad que se exponga a través del modelo de propiedades unificado.
Para obtener información sobre los métodos relacionados, consulte Acceso al modelo de propiedades de dispositivo unificado.
Requisitos
| Requisito | Value |
|---|---|
| Plataforma de destino | Universal |
| Versión mínima de KMDF | 1.13 |
| Versión mínima de UMDF | 2.0 |
| Encabezado | wdfdevice.h (incluir Wdf.h) |
| Library | Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF) |
| IRQL | APC_LEVEL |