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

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

Sintaxe

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

Parâmetros

[in] refguid

Tipo: REFGUID

Referência a (C++) ou endereço de (C) o identificador global exclusivo que identifica os dados privados a serem recuperados.

[in, out] pData

Tipo: void*

Ponteiro para um buffer alocado anteriormente para preencher 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.

Valor de retorno

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.

Observações

Se os dados retornados forem um ponteiro para um IUnknown ou uma de suas classes derivadas, que foi definida anteriormente por SetPrivateData com um D3DSPD_IUNKNOWN sinalizador, essa interface terá sua contagem de referência incrementada antes que os dados privados sejam retornados.

Requisitos

Requisito	Valor
da Plataforma de Destino	Windows
cabeçalho	d3d9helper.h (inclua D3D9.h)
Biblioteca	D3D9.lib

Consulte também

IDirect3DVolume9

IDirect3DVolume9::FreePrivateData

IDirect3DVolume9::SetPrivateData