Share via

IDirect3DResource9::GetPrivateData-Methode (d3d9helper.h)

  • Artikel

Kopiert die privaten Daten, die der Ressource zugeordnet sind, in einen bereitgestellten Puffer.

Syntax

HRESULT GetPrivateData(
  [in]      REFGUID refguid,
  [in, out] void    *pData,
  [in, out] DWORD   *pSizeOfData
);

Parameter

[in] refguid

Typ: REFGUID

Der global eindeutige Bezeichner, der die abzurufenden privaten Daten identifiziert.

[in, out] pData

Typ: void*

Zeiger auf einen zuvor zugeordneten Puffer, der mit den angeforderten privaten Daten gefüllt werden soll, wenn der Aufruf erfolgreich ist. Die Anwendung, die diese Methode aufruft, ist für die Zuweisung und Freigabe dieses Puffers verantwortlich. Wenn dieser Parameter NULL ist, gibt diese Methode die Puffergröße in pSizeOfData zurück.

[in, out] pSizeOfData

Typ: DWORD*

Zeiger auf die Größe des Puffers bei pData in Bytes. Wenn dieser Wert kleiner als die tatsächliche Größe der privaten Daten ist (z. B. 0), legt die Methode diesen Parameter auf die erforderliche Puffergröße fest, und die Methode gibt D3DERR_MOREDATA zurück.

Rückgabewert

Typ: HRESULT

Wenn die Methode erfolgreich ist, wird der Rückgabewert D3D_OK. Wenn die Methode fehlschlägt, kann der Rückgabewert einer der folgenden sein: D3DERR_INVALIDCALL, D3DERR_MOREDATA, D3DERR_NOTFOUND.

Hinweise

Diese Methode wird von den folgenden Schnittstellen geerbt:

IDirect3DResource9,

IDirect3DBaseTexture9,

IDirect3DCubeTexture9,

IDirect3DTexture9,

IDirect3DVolumeTexture9,

IDirect3DIndexBuffer9,

IDirect3DVertexBuffer9.

Anforderungen

Anforderung Wert
Zielplattform Windows
Kopfzeile d3d9helper.h (include D3D9.h)
Bibliothek D3D9.lib

Weitere Informationen

IDirect3DResource9