Partager via


MÉTHODE ID2D1Properties::GetValueByName(PCWSTR,BYTE*,UINT32) (d2d1_1.h)

Obtient la valeur de la propriété par nom.

Syntaxe

HRESULT GetValueByName(
  [in]  PCWSTR name,
  [out] BYTE   *data,
        UINT32 dataSize
);

Paramètres

[in] name

Type : PCWSTR

Nom de propriété à obtenir.

[out] data

Type : BYTE*

Lorsque cette méthode est retournée, contient la mémoire tampon avec la valeur de données.

dataSize

Type : UINT32

Nombre d’octets dans les données à récupérer.

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 le nom n’existe pas, aucune information n’est récupérée.

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