IDirect3DResource9::GetPrivateData-Methode (d3d9.h)

Artikel
03/04/2024

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 zugewiesenen 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.