www.pudn.com > SGSDK.rar > dxfile.h, change:2004-09-27,size:8155b


/*************************************************************************** 
 * 
 *  Copyright (C) 1998-1999 Microsoft Corporation.  All Rights Reserved. 
 * 
 *  File:       dxfile.h 
 * 
 *  Content:    DirectX File public header file 
 * 
 ***************************************************************************/ 
 
#ifndef __DXFILE_H__ 
#define __DXFILE_H__ 
 
#ifdef __cplusplus 
extern "C" { 
#endif 
 
typedef DWORD DXFILEFORMAT; 
 
#define DXFILEFORMAT_BINARY     0 
#define DXFILEFORMAT_TEXT       1 
#define DXFILEFORMAT_COMPRESSED 2 
 
typedef DWORD DXFILELOADOPTIONS; 
 
#define DXFILELOAD_FROMFILE  0x00L 
#define DXFILELOAD_FROMRESOURCE 0x01L 
#define DXFILELOAD_FROMMEMORY 0x02L 
#define DXFILELOAD_FROMSTREAM 0x04L 
#define DXFILELOAD_FROMURL 0x08L 
 
typedef struct _DXFILELOADRESOURCE { 
    HMODULE hModule; 
    LPCTSTR lpName; 
    LPCTSTR lpType; 
}DXFILELOADRESOURCE, *LPDXFILELOADRESOURCE; 
 
typedef struct _DXFILELOADMEMORY { 
    LPVOID lpMemory; 
    DWORD dSize; 
}DXFILELOADMEMORY, *LPDXFILELOADMEMORY; 
 
/* 
 * DirectX File object types. 
 */ 
 
#ifndef WIN_TYPES 
#define WIN_TYPES(itype, ptype) typedef interface itype *LP##ptype, **LPLP##ptype 
#endif 
 
WIN_TYPES(IDirectXFile,                 DIRECTXFILE); 
WIN_TYPES(IDirectXFileEnumObject,       DIRECTXFILEENUMOBJECT); 
WIN_TYPES(IDirectXFileSaveObject,       DIRECTXFILESAVEOBJECT); 
WIN_TYPES(IDirectXFileObject,           DIRECTXFILEOBJECT); 
WIN_TYPES(IDirectXFileData,             DIRECTXFILEDATA); 
WIN_TYPES(IDirectXFileDataReference,    DIRECTXFILEDATAREFERENCE); 
WIN_TYPES(IDirectXFileBinary,           DIRECTXFILEBINARY); 
 
/* 
 * API for creating IDirectXFile interface. 
 */ 
 
STDAPI DirectXFileCreate(LPDIRECTXFILE *lplpDirectXFile); 
 
/* 
 * The methods for IUnknown 
 */ 
 
#define IUNKNOWN_METHODS(kind) \ 
    STDMETHOD(QueryInterface)       (THIS_ REFIID riid, LPVOID *ppvObj) kind; \ 
    STDMETHOD_(ULONG, AddRef)       (THIS) kind; \ 
    STDMETHOD_(ULONG, Release)      (THIS) kind 
 
/* 
 * The methods for IDirectXFileObject 
 */ 
 
#define IDIRECTXFILEOBJECT_METHODS(kind) \ 
    STDMETHOD(GetName) (THIS_ LPSTR, LPDWORD) kind; \ 
    STDMETHOD(GetId) (THIS_ LPGUID) kind 
 
/* 
 * DirectX File interfaces. 
 */ 
 
#undef INTERFACE 
#define INTERFACE IDirectXFile 
 
DECLARE_INTERFACE_(IDirectXFile, IUnknown) 
{ 
    IUNKNOWN_METHODS(PURE); 
    STDMETHOD(CreateEnumObject) (THIS_ LPVOID, DXFILELOADOPTIONS, 
                                 LPDIRECTXFILEENUMOBJECT *) PURE; 
    STDMETHOD(CreateSaveObject) (THIS_ LPCSTR, DXFILEFORMAT, 
                                 LPDIRECTXFILESAVEOBJECT *) PURE; 
    STDMETHOD(RegisterTemplates) (THIS_ LPVOID, DWORD) PURE; 
}; 
 
#undef INTERFACE 
#define INTERFACE IDirectXFileEnumObject 
 
DECLARE_INTERFACE_(IDirectXFileEnumObject, IUnknown) 
{ 
    IUNKNOWN_METHODS(PURE); 
    STDMETHOD(GetNextDataObject)    (THIS_ LPDIRECTXFILEDATA *) PURE; 
    STDMETHOD(GetDataObjectById)    (THIS_ REFGUID, LPDIRECTXFILEDATA *) PURE; 
    STDMETHOD(GetDataObjectByName)  (THIS_ LPCSTR, LPDIRECTXFILEDATA *) PURE; 
}; 
 
#undef INTERFACE 
#define INTERFACE IDirectXFileSaveObject 
 
DECLARE_INTERFACE_(IDirectXFileSaveObject, IUnknown) 
{ 
    IUNKNOWN_METHODS(PURE); 
    STDMETHOD(SaveTemplates) (THIS_ DWORD, const GUID **) PURE; 
    STDMETHOD(CreateDataObject) (THIS_ REFGUID, LPCSTR, const GUID *, 
                                 DWORD, LPVOID, LPDIRECTXFILEDATA *) PURE; 
    STDMETHOD(SaveData) (THIS_ LPDIRECTXFILEDATA) PURE; 
}; 
 
 
#undef INTERFACE 
#define INTERFACE IDirectXFileObject 
 
DECLARE_INTERFACE_(IDirectXFileObject, IUnknown) 
{ 
    IUNKNOWN_METHODS(PURE); 
    IDIRECTXFILEOBJECT_METHODS(PURE); 
}; 
 
#undef INTERFACE 
#define INTERFACE IDirectXFileData 
 
DECLARE_INTERFACE_(IDirectXFileData, IDirectXFileObject) 
{ 
    IUNKNOWN_METHODS(PURE); 
    IDIRECTXFILEOBJECT_METHODS(PURE); 
 
    STDMETHOD(GetData)          (THIS_ LPCSTR, DWORD *, void **) PURE; 
    STDMETHOD(GetType)          (THIS_ const GUID **) PURE; 
    STDMETHOD(GetNextObject)    (THIS_ LPDIRECTXFILEOBJECT *) PURE; 
    STDMETHOD(AddDataObject)    (THIS_ LPDIRECTXFILEDATA) PURE; 
    STDMETHOD(AddDataReference) (THIS_ LPCSTR, const GUID *) PURE; 
    STDMETHOD(AddBinaryObject)  (THIS_ LPCSTR, const GUID *, LPCSTR, LPVOID, DWORD) PURE; 
}; 
 
#undef INTERFACE 
#define INTERFACE IDirectXFileDataReference 
 
DECLARE_INTERFACE_(IDirectXFileDataReference, IDirectXFileObject) 
{ 
    IUNKNOWN_METHODS(PURE); 
    IDIRECTXFILEOBJECT_METHODS(PURE); 
 
    STDMETHOD(Resolve) (THIS_ LPDIRECTXFILEDATA *) PURE; 
}; 
 
#undef INTERFACE 
#define INTERFACE IDirectXFileBinary 
 
DECLARE_INTERFACE_(IDirectXFileBinary, IDirectXFileObject) 
{ 
    IUNKNOWN_METHODS(PURE); 
    IDIRECTXFILEOBJECT_METHODS(PURE); 
 
    STDMETHOD(GetSize)      (THIS_ DWORD *) PURE; 
    STDMETHOD(GetMimeType)  (THIS_ LPCSTR *) PURE; 
    STDMETHOD(Read)         (THIS_ LPVOID, DWORD, LPDWORD) PURE; 
}; 
 
/* 
 * DirectXFile Object Class Id (for CoCreateInstance()) 
 */ 
 
DEFINE_GUID(CLSID_CDirectXFile, 0x4516ec43, 0x8f20, 0x11d0, 0x9b, 0x6d, 0x00, 0x00, 0xc0, 0x78, 0x1b, 0xc3); 
 
/* 
 * DirectX File Interface GUIDs. 
 */ 
 
DEFINE_GUID(IID_IDirectXFile,               0x3d82ab40, 0x62da, 0x11cf, 0xab, 0x39, 0x0, 0x20, 0xaf, 0x71, 0xe4, 0x33); 
DEFINE_GUID(IID_IDirectXFileEnumObject,     0x3d82ab41, 0x62da, 0x11cf, 0xab, 0x39, 0x0, 0x20, 0xaf, 0x71, 0xe4, 0x33); 
DEFINE_GUID(IID_IDirectXFileSaveObject,     0x3d82ab42, 0x62da, 0x11cf, 0xab, 0x39, 0x0, 0x20, 0xaf, 0x71, 0xe4, 0x33); 
DEFINE_GUID(IID_IDirectXFileObject,         0x3d82ab43, 0x62da, 0x11cf, 0xab, 0x39, 0x0, 0x20, 0xaf, 0x71, 0xe4, 0x33); 
DEFINE_GUID(IID_IDirectXFileData,           0x3d82ab44, 0x62da, 0x11cf, 0xab, 0x39, 0x0, 0x20, 0xaf, 0x71, 0xe4, 0x33); 
DEFINE_GUID(IID_IDirectXFileDataReference,  0x3d82ab45, 0x62da, 0x11cf, 0xab, 0x39, 0x0, 0x20, 0xaf, 0x71, 0xe4, 0x33); 
DEFINE_GUID(IID_IDirectXFileBinary,         0x3d82ab46, 0x62da, 0x11cf, 0xab, 0x39, 0x0, 0x20, 0xaf, 0x71, 0xe4, 0x33); 
 
/* 
 * DirectX File Header template's GUID. 
 */ 
 
DEFINE_GUID(TID_DXFILEHeader,   0x3d82ab43, 0x62da, 0x11cf, 0xab, 0x39, 0x0, 0x20, 0xaf, 0x71, 0xe4, 0x33); 
 
 
/* 
 * DirectX File errors. 
 */ 
 
#define _FACDD  0x876 
#define MAKE_DDHRESULT( code )  MAKE_HRESULT( 1, _FACDD, code ) 
 
#define DXFILE_OK   0 
 
#define DXFILEERR_BADOBJECT                 MAKE_DDHRESULT(850) 
#define DXFILEERR_BADVALUE                  MAKE_DDHRESULT(851) 
#define DXFILEERR_BADTYPE                   MAKE_DDHRESULT(852) 
#define DXFILEERR_BADSTREAMHANDLE           MAKE_DDHRESULT(853) 
#define DXFILEERR_BADALLOC                  MAKE_DDHRESULT(854) 
#define DXFILEERR_NOTFOUND                  MAKE_DDHRESULT(855) 
#define DXFILEERR_NOTDONEYET                MAKE_DDHRESULT(856) 
#define DXFILEERR_FILENOTFOUND              MAKE_DDHRESULT(857) 
#define DXFILEERR_RESOURCENOTFOUND          MAKE_DDHRESULT(858) 
#define DXFILEERR_URLNOTFOUND               MAKE_DDHRESULT(859) 
#define DXFILEERR_BADRESOURCE               MAKE_DDHRESULT(860) 
#define DXFILEERR_BADFILETYPE               MAKE_DDHRESULT(861) 
#define DXFILEERR_BADFILEVERSION            MAKE_DDHRESULT(862) 
#define DXFILEERR_BADFILEFLOATSIZE          MAKE_DDHRESULT(863) 
#define DXFILEERR_BADFILECOMPRESSIONTYPE    MAKE_DDHRESULT(864) 
#define DXFILEERR_BADFILE                   MAKE_DDHRESULT(865) 
#define DXFILEERR_PARSEERROR                MAKE_DDHRESULT(866) 
#define DXFILEERR_NOTEMPLATE                MAKE_DDHRESULT(867) 
#define DXFILEERR_BADARRAYSIZE              MAKE_DDHRESULT(868) 
#define DXFILEERR_BADDATAREFERENCE          MAKE_DDHRESULT(869) 
#define DXFILEERR_INTERNALERROR             MAKE_DDHRESULT(870) 
#define DXFILEERR_NOMOREOBJECTS             MAKE_DDHRESULT(871) 
#define DXFILEERR_BADINTRINSICS             MAKE_DDHRESULT(872) 
#define DXFILEERR_NOMORESTREAMHANDLES       MAKE_DDHRESULT(873) 
#define DXFILEERR_NOMOREDATA                MAKE_DDHRESULT(874) 
#define DXFILEERR_BADCACHEFILE              MAKE_DDHRESULT(875) 
#define DXFILEERR_NOINTERNET                MAKE_DDHRESULT(876) 
 
 
#ifdef __cplusplus 
}; 
#endif 
 
#endif /* _DXFILE_H_ */