IDirectDrawSurface7::GetPrivateData-Methode (ddraw.h)
Kopiert die privaten Daten, die dieser Oberfläche zugeordnet sind, in einen bereitgestellten Puffer.
Syntax
HRESULT GetPrivateData(
[in] REFGUID unnamedParam1,
[out] LPVOID unnamedParam2,
[in, out] LPDWORD unnamedParam3
);
Parameter
[in] unnamedParam1
Verweisen Sie auf (C++) oder die Adresse von (C) auf den global eindeutigen Bezeichner, der die abzurufenden privaten Daten identifiziert.
[out] unnamedParam2
Ein Zeiger auf einen zuvor zugewiesenen Puffer, der die angeforderten privaten Daten empfängt, wenn der Aufruf erfolgreich ist. Die Anwendung, die diese Methode aufruft, muss diesen Puffer zuordnen und freigeben.
[in, out] unnamedParam3
Ein Zeiger auf eine Variable, die den Größenwert des Puffers bei lpBuffer in Bytes enthält. Wenn dieser Wert kleiner als die tatsächliche Größe der privaten Daten ist (z. B. 0), legt GetPrivateData die Variable auf die erforderliche Puffergröße fest und gibt dann DDERR_MOREDATA zurück.
Rückgabewert
Wenn die Methode erfolgreich ist, wird der Rückgabewert DD_OK.
Wenn ein Fehler auftritt, kann die Methode einen der folgenden Fehlerwerte zurückgeben:
- DDERR_EXPIRED
- DDERR_INVALIDOBJECT
- DDERR_INVALIDPARAMS
- DDERR_MOREDATA
- DDERR_NOTFOUND
- DDERR_OUTOFMEMORY
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Windows |
| Kopfzeile | ddraw.h |
| Bibliothek | Ddraw.lib |
| DLL | Ddraw.dll |