Partager via


ID2D1Properties::SetValueByName(PCWSTR,constBYTE*,UINT32) méthode (d2d1_1.h)

Définit la propriété nommée sur la valeur donnée.

Syntaxe

HRESULT SetValueByName(
  [in] PCWSTR     name,
  [in] const BYTE *data,
       UINT32     dataSize
);

Paramètres

[in] name

Type : PCWSTR

Nom de la propriété à définir.

[in] data

Type : const BYTE*

Données à définir.

dataSize

Type : UINT32

Nombre d’octets dans les données à définir.

Valeur retournée

Type : HRESULT

Cette méthode retourne un code HRESULT. Les valeurs possibles sont notamment celles figurant dans le tableau suivant.

HRESULT Description
S_OK Aucune erreur ne s'est produite.
D2DERR_INVALID_PROPERTY La propriété spécifiée n’existe pas.
E_OUTOFMEMORY Échec de l’allocation de la mémoire nécessaire.
D3DERR_OUT_OF_VIDEO_MEMORY Échec de l’allocation de la mémoire vidéo requise.
E_INVALIDARG Un ou plusieurs arguments ne sont pas valides.
E_FAIL Défaillance non spécifiée.

Remarques

Si la propriété n’existe pas, la requête est ignorée et la méthode retourne D2DERR_INVALID_PROPERTY.

Toute erreur qui ne se trouve pas dans le jeu standard retourné par une implémentation de propriété est mappée dans la plage d’erreurs standard.

Configuration requise

   
Client minimal pris en charge Windows 8 et mise à jour de plateforme pour Windows 7 [applications de bureau | Applications UWP]
Serveur minimal pris en charge Windows Server 2012 et Platform Update pour Windows Server 2008 R2 [applications de bureau | Applications UWP]
Plateforme cible Windows
En-tête d2d1_1.h
Bibliothèque D2d1.lib
DLL D2d1.dll

Voir aussi

ID2D1DeviceContext::CreateEffect

ID2D1Properties