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:

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

Consulte también

WdfDeviceAssignInterfaceProperty