Método IDirect3DResource9::GetPrivateData (d3d9helper.h)

Artigo
02/27/2024

Copia os dados privados associados ao recurso para um buffer fornecido.

Sintaxe

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

Parâmetros

[in] refguid

Tipo: REFGUID

O identificador global exclusivo que identifica os dados privados a serem recuperados.

[in, out] pData

Tipo: void*

Ponteiro para um buffer alocado anteriormente a ser preenchido com os dados privados solicitados se a chamada for bem-sucedida. O aplicativo que chama esse método é responsável por alocar e liberar esse buffer. Se esse parâmetro for NULL, esse método retornará o tamanho do buffer em pSizeOfData.

[in, out] pSizeOfData

Tipo: DWORD*

Ponteiro para o tamanho do buffer em pData, em bytes. Se esse valor for menor que o tamanho real dos dados privados (como 0), o método definirá esse parâmetro como o tamanho do buffer necessário e o método retornará D3DERR_MOREDATA.

Retornar valor

Tipo: HRESULT

Se o método for bem-sucedido, o valor retornado será D3D_OK. Se o método falhar, o valor retornado poderá ser um dos seguintes: D3DERR_INVALIDCALL, D3DERR_MOREDATA D3DERR_NOTFOUND.