Méthode IDirectDrawSurface7 ::GetPrivateData (ddraw.h)
Copie les données privées associées à cette surface dans une mémoire tampon fournie.
Syntaxe
HRESULT GetPrivateData(
[in] REFGUID unnamedParam1,
[out] LPVOID unnamedParam2,
[in, out] LPDWORD unnamedParam3
);
Paramètres
[in] unnamedParam1
Référence à (C++) ou à l’adresse de (C) l’identificateur global unique qui identifie les données privées à récupérer.
[out] unnamedParam2
Pointeur vers une mémoire tampon précédemment allouée qui reçoit les données privées demandées si l’appel réussit. L’application qui appelle cette méthode doit allouer et libérer cette mémoire tampon.
[in, out] unnamedParam3
Pointeur vers une variable qui contient la valeur de taille de la mémoire tampon au niveau de lpBuffer, en octets. Si cette valeur est inférieure à la taille réelle des données privées (par exemple, 0), GetPrivateData définit la variable sur la taille de mémoire tampon requise, puis retourne DDERR_MOREDATA.
Valeur retournée
Si la méthode réussit, la valeur de retour est DD_OK.
En cas d’échec, la méthode peut retourner l’une des valeurs d’erreur suivantes :
- DDERR_EXPIRED
- DDERR_INVALIDOBJECT
- DDERR_INVALIDPARAMS
- DDERR_MOREDATA
- DDERR_NOTFOUND
- DDERR_OUTOFMEMORY
Configuration requise
| Condition requise | Valeur |
|---|---|
| Plateforme cible | Windows |
| En-tête | ddraw.h |
| Bibliothèque | Ddraw.lib |
| DLL | Ddraw.dll |