ID2D1Properties::SetValueByName(PCWSTR,constBYTE*,UINT32)-Methode (d2d1_1.h)
Legt die benannte Eigenschaft auf den angegebenen Wert fest.
Syntax
HRESULT SetValueByName(
[in] PCWSTR name,
[in] const BYTE *data,
UINT32 dataSize
);
Parameter
[in] name
Typ: PCWSTR
Der Name der festzulegenden Eigenschaft.
[in] data
Typ: const BYTE*
Die festzulegenden Daten.
dataSize
Typ: UINT32
Die Anzahl der Bytes in den festzulegenden Daten.
Rückgabewert
Typ: HRESULT
Die Methode gibt ein HRESULT zurück. Mögliches Werte (aber nicht die Einzigen) sind die in der folgenden Tabelle.
| HRESULT | BESCHREIBUNG |
|---|---|
| S_OK | Kein Fehler ist aufgetreten. |
| D2DERR_INVALID_PROPERTY | Die angegebene Eigenschaft ist nicht vorhanden. |
| E_OUTOFMEMORY | Fehler beim Zuweisen des erforderlichen Arbeitsspeichers. |
| D3DERR_OUT_OF_VIDEO_MEMORY | Fehler beim Zuweisen des erforderlichen Videospeichers. |
| E_INVALIDARG | Mindestens ein Argument ist ungültig. |
| E_FAIL | Unspezifizierter Fehler. |
Hinweise
Wenn die -Eigenschaft nicht vorhanden ist, wird die Anforderung ignoriert, und die Methode gibt D2DERR_INVALID_PROPERTY zurück.
Alle Fehler, die nicht im Standardsatz enthalten sind, der von einer Eigenschaftsimplementierung zurückgegeben wird, werden dem Standardfehlerbereich zugeordnet.
Anforderungen
| Unterstützte Mindestversion (Client) | Windows 8 und Plattformupdate für Windows 7 [Desktop-Apps | UWP-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2012 und Plattformupdate für Windows Server 2008 R2 [Desktop-Apps | UWP-Apps] |
| Zielplattform | Windows |
| Kopfzeile | d2d1_1.h |
| Bibliothek | D2d1.lib |
| DLL | D2d1.dll |