Función WdfDeviceAssignInterfaceProperty (wdfdevice.h)

El método WdfDeviceAssignInterfaceProperty modifica el valor actual de una propiedad de interfaz de dispositivo.

Sintaxis

NTSTATUS WdfDeviceAssignInterfaceProperty(
  [in]           WDFDEVICE                           Device,
  [in]           PWDF_DEVICE_INTERFACE_PROPERTY_DATA PropertyData,
  [in]           DEVPROPTYPE                         Type,
  [in]           ULONG                               BufferLength,
  [in, optional] PVOID                               PropertyBuffer
);

Parámetros

[in] Device

Identificador de un objeto de dispositivo de marco.

[in] PropertyData

Puntero a WDF_DEVICE_INTERFACE_PROPERTY_DATA estructura.

[in] Type

Valor con tipo DEVPROPTYPE que especifica el tipo de los datos proporcionados en PropertyBuffer.

[in] BufferLength

Especifica la longitud, en bytes, del búfer al que apunta PropertyBuffer .

[in, optional] PropertyBuffer

Puntero a los datos de propiedad de la interfaz de dispositivo. Establezca este parámetro en NULL para eliminar la propiedad especificada.

Valor devuelto

Si el método WdfDeviceAssignInterfaceProperty no encuentra ningún error, devuelve STATUS_SUCCESS. Entre los valores devueltos adicionales se incluyen:

El método podría devolver otros valores NTSTATUS.

Comentarios

Para obtener información sobre los métodos relacionados, consulte Acceso al modelo de propiedades de dispositivo unificado.

Ejemplos

En el ejemplo de código siguiente se inicializa una estructura de WDF_DEVICE_INTERFACE_PROPERTY_DATA y, a continuación, se llama a WdfDeviceAssignInterfaceProperty.

DEFINE_DEVPROPKEY(DEVPKEY_ToasterCrispLevelDword, 0x5d0ba64a, 0x2396, 0x4bc9, 0xbf, 0x49, 0x52, 0x1d, 0xa6, 0x2b, 0x1b, 0xed, 3);  // DEVPROP_TYPE_UINT32

ULONG crispLevel = 0;
WDF_DEVICE_INTERFACE_PROPERTY_DATA propertyData;

WDF_DEVICE_INTERFACE_PROPERTY_DATA_INIT(
                          &propertyData, 
                          &GUID_DEVINTERFACE_TOASTER_DRIVER
                          &DEVPKEY_ToasterCrispLevelDword
                          );

status = WdfDeviceAssignInterfaceProperty(device, 
                                          &propertData,
                                          DEVPROP_TYPE_UINT32,
                                          sizeof(crispLevel),
                                          &crispLevel);
if (!NT_SUCCESS(status)) {
    return status;
}

Requisitos

Consulte también

WDF_DEVICE_INTERFACE_PROPERTY_DATA

WDF_DEVICE_INTERFACE_PROPERTY_DATA_INIT

WdfDeviceAllocAndQueryInterfaceProperty

WdfDeviceQueryInterfaceProperty