Diligent Engine  v.2.4.g
FileStream.h
Go to the documentation of this file.
1 /*
2  * Copyright 2019-2021 Diligent Graphics LLC
3  * Copyright 2015-2019 Egor Yusov
4  *
5  * Licensed under the Apache License, Version 2.0 (the "License");
6  * you may not use this file except in compliance with the License.
7  * You may obtain a copy of the License at
8  *
9  * http://www.apache.org/licenses/LICENSE-2.0
10  *
11  * Unless required by applicable law or agreed to in writing, software
12  * distributed under the License is distributed on an "AS IS" BASIS,
13  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14  * See the License for the specific language governing permissions and
15  * limitations under the License.
16  *
17  * In no event and under no legal theory, whether in tort (including negligence),
18  * contract, or otherwise, unless required by applicable law (such as deliberate
19  * and grossly negligent acts) or agreed to in writing, shall any Contributor be
20  * liable for any damages, including any direct, indirect, special, incidental,
21  * or consequential damages of any character arising as a result of this License or
22  * out of the use or inability to use the software (including but not limited to damages
23  * for loss of goodwill, work stoppage, computer failure or malfunction, or any and
24  * all other commercial damages or losses), even if such Contributor has been advised
25  * of the possibility of such damages.
26  */
27 
28 #pragma once
29 
32 
33 #include "Object.h"
34 #include "DataBlob.h"
35 
37 
38 // {E67F386C-6A5A-4A24-A0CE-C66435465D41}
40 static const struct INTERFACE_ID IID_FileStream =
41  {0xe67f386c, 0x6a5a, 0x4a24, {0xa0, 0xce, 0xc6, 0x64, 0x35, 0x46, 0x5d, 0x41}};
42 
43 // clang-format off
44 
45 #define DILIGENT_INTERFACE_NAME IFileStream
47 
48 #define IFileStreamInclusiveMethods \
49  IObjectInclusiveMethods; \
50  IFileStreamMethods FileStream
51 
54 {
56  VIRTUAL bool METHOD(Read)(THIS_
57  void* Data,
58  size_t BufferSize) PURE;
59 
60  VIRTUAL void METHOD(ReadBlob)(THIS_
61  IDataBlob* pData) PURE;
62 
64  VIRTUAL bool METHOD(Write)(THIS_
65  const void* Data,
66  size_t Size) PURE;
67 
68  VIRTUAL size_t METHOD(GetSize)(THIS) PURE;
69 
70  VIRTUAL bool METHOD(IsValid)(THIS) PURE;
71 };
73 
75 
76 #if DILIGENT_C_INTERFACE
77 
78 // clang-format off
79 
80 # define IFileStream_Read(This, ...) CALL_IFACE_METHOD(FileStream, Read, This, __VA_ARGS__)
81 # define IFileStream_ReadBlob(This, ...) CALL_IFACE_METHOD(FileStream, ReadBlob, This, __VA_ARGS__)
82 # define IFileStream_Write(This, ...) CALL_IFACE_METHOD(FileStream, Write, This, __VA_ARGS__)
83 # define IFileStream_GetSize(This) CALL_IFACE_METHOD(FileStream, GetSize, This)
84 # define IFileStream_IsValid(This) CALL_IFACE_METHOD(FileStream, IsValid, This)
85 
86 // clang-format on
87 
88 #endif
89 
90 DILIGENT_END_NAMESPACE // namespace Diligent
DILIGENT_END_INTERFACE
#define DILIGENT_END_INTERFACE
Definition: DefineInterfaceHelperMacros.h:88
Diligent::INTERFACE_ID
struct INTERFACE_ID INTERFACE_ID
Definition: InterfaceID.h:54
VIRTUAL
#define VIRTUAL
Definition: DefineInterfaceHelperMacros.h:83
DefineInterfaceHelperMacros.h
Diligent::IDataBlob
Base interface for a file stream.
Definition: DataBlob.h:52
DILIGENT_BEGIN_INTERFACE
#define DILIGENT_BEGIN_INTERFACE(Name, Base)
Definition: CommonDefinitions.h:97
Diligent::IObject
Base interface for all dynamic objects in the engine.
Definition: Object.h:41
THIS
#define THIS
Definition: DefineInterfaceHelperMacros.h:81
EFileAccessMode::Read
@ Read
PURE
#define PURE
Definition: DefineInterfaceHelperMacros.h:85
DataBlob.h
DILIGENT_END_NAMESPACE
#define DILIGENT_END_NAMESPACE
Definition: CommonDefinitions.h:86
Diligent::IFileStream
Base interface for a file stream.
Definition: FileStream.h:53
UndefInterfaceHelperMacros.h
Object.h
METHOD
#define METHOD(Name)
Definition: DefineInterfaceHelperMacros.h:87
DILIGENT_BEGIN_NAMESPACE
#define DILIGENT_BEGIN_NAMESPACE(Name)
Definition: CommonDefinitions.h:82
Diligent
The library uses Direct3D-style math:
Definition: AdvancedMath.hpp:37
THIS_
#define THIS_
Definition: DefineInterfaceHelperMacros.h:82