WdfDeviceAssignInterfaceProperty, fonction (wdfdevice.h)

La méthode WdfDeviceAssignInterfaceProperty modifie la valeur actuelle d’une propriété d’interface d’appareil .

Syntaxe

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

Paramètres

[in] Device

Handle vers un objet d’appareil framework.

[in] PropertyData

Pointeur vers WDF_DEVICE_INTERFACE_PROPERTY_DATA structure.

[in] Type

Valeur DEVPROPTYPE-typée qui spécifie le type des données fournies dans PropertyBuffer.

[in] BufferLength

Spécifie la longueur, en octets, de la mémoire tampon vers laquelle PropertyBuffer pointe.

[in, optional] PropertyBuffer

Pointeur vers les données de propriété de l’interface de l’appareil. Définissez ce paramètre sur NULL pour supprimer la propriété spécifiée.

Valeur de retour

Si la méthode WdfDeviceAssignInterfaceProperty ne rencontre aucune erreur, elle retourne STATUS_SUCCESS. Les valeurs de retour supplémentaires sont les suivantes :

La méthode peut retourner d’autres valeurs NTSTATUS .

Remarques

Pour plus d’informations sur les méthodes associées, consultez Accès au modèle de propriété d’appareil unifié.

Exemples

L’exemple de code suivant initialise une structure WDF_DEVICE_INTERFACE_PROPERTY_DATA, puis appelle 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;
}

Exigences

Voir aussi

WDF_DEVICE_INTERFACE_PROPERTY_DATA

WDF_DEVICE_INTERFACE_PROPERTY_DATA_INIT

WdfDeviceAllocAndQueryInterfaceProperty

WdfDeviceQueryInterfaceProperty