Compartilhar via


Método IDirectXFileSaveObject::CreateDataObject

Cria um objeto de dados. Preterido.

Sintaxe

HRESULT CreateDataObject(
  [in]                REFGUID           rguidTemplate,
  [in]                LPCSTR            szName,
  [in]          const GUID              *pguid,
  [in]                DWORD             cbSize,
  [in]                LPVOID            pvData,
  [out, retval]       LPDIRECTXFILEDATA *ppDataObj
);

Parâmetros

rguidTemplate [in]

Tipo: REFGUID

GUID que representa o modelo do objeto de dados.

szName [in]

Tipo: LPCSTR

Ponteiro para o nome do objeto de dados. Especifique NULL se o objeto não tiver um nome.

pguid [in]

Tipo: const GUID*

Ponteiro para um GUID que representa o objeto de dados. Especifique NULL se o objeto não tiver um GUID.

cbSize [in]

Tipo: DWORD

Tamanho do objeto de dados, em bytes.

pvData [in]

Tipo: LPVOID

Ponteiro para um buffer que contém todos os dados de membro necessários.

ppDataObj [out, retval]

Tipo: LPDIRECTXFILEDATA*

Endereço de um ponteiro para uma interface IDirectXFileData , representando o objeto de dados de arquivo criado.

Valor retornado

Tipo: HRESULT

Se o método for bem-sucedido, o valor retornado será DXFILE_OK. Se o método falhar, o valor retornado poderá ser um dos valores a seguir. DXFILEERR_BADALLOC DXFILEERR_BADVALUE

Comentários

Se um objeto de referência de dados fizer referência ao objeto de dados, o parâmetro szName ou pguid deverá ser não NULL.

Salve todos os modelos usando o método IDirectXFileSaveObject::SaveTemplates antes de salvar os dados criados por esse método. Salve os dados criados usando o método IDirectXFileSaveObject::SaveData .

Se você precisar salvar dados opcionais, use o método IDirectXFileData::AddDataObject depois de usar esse método e antes de usar IDirectXFileSaveObject::SaveData. Se o objeto tiver objetos filho, adicione-os antes de chamar IDirectXFileSaveObject::SaveData.

Requisitos

Requisito Valor
parâmetro
DXFile.h
Biblioteca
D3dxof.lib

Confira também

IDirectXFileSaveObject

IDirectXFileData::AddDataObject

IDirectXFileSaveObject::SaveData

IDirectXFileSaveObject::SaveTemplates