Audiokinetic

Wwise SDK 2023.1.18

 /*******************************************************************************
 The content of this file includes portions of the AUDIOKINETIC Wwise Technology
 released in source code form as part of the SDK installer package.
  
 Commercial License Usage
  
 Licensees holding valid commercial licenses to the AUDIOKINETIC Wwise Technology
 may use this file in accordance with the end user license agreement provided 
 with the software or, alternatively, in accordance with the terms contained in a
 written agreement between you and Audiokinetic Inc.
  
 Apache License Usage
  
 Alternatively, this file may be used under the Apache License, Version 2.0 (the 
 "Apache License"); you may not use this file except in compliance with the 
 Apache License. You may obtain a copy of the Apache License at 
 http://www.apache.org/licenses/LICENSE-2.0.
  
 Unless required by applicable law or agreed to in writing, software distributed
 under the Apache License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES
 OR CONDITIONS OF ANY KIND, either express or implied. See the Apache License for
 the specific language governing permissions and limitations under the License.
  
   Copyright (c) 2025 Audiokinetic Inc.
 *******************************************************************************/
  
 /// \file
 /// Wwise source control plug-in interface, used to implement the source control plug-in.
  
 #ifndef _AK_WWISE_ISOURCECONTROL_H
 #define _AK_WWISE_ISOURCECONTROL_H
  
 // Include the header file that defines the BSTR type.
 #ifdef AK_WIN
 #include 
 #endif
  
 #include "ISourceControlUtilities.h"
 #include "SourceControlContainers.h"
  
 // Audiokinetic namespace
 namespace AK
 {
     // Audiokinetic Wwise namespace
     namespace Wwise
     {
         /// This class contains static constants that can be useful to the plug-in.
         class SourceControlConstant
         {
         public: 
             /// Maximum length that a work unit name can be
             static const unsigned int s_uiMaxWorkUnitName = 128;
             /// Invalid operation ID (MUST NOT BE USED as an operation ID in OperationListItem)
             static const DWORD s_dwInvalidOperationID = (DWORD)-1;
         };
  
         /// Wwise source control plug-in interface. This is the interface that the plug-in must implement. It contains
         /// all the necessary functions to perform source control operations and manage the Wwise source control UI.
         /// \akwarning
         /// The functions in this interface are not thread-safe, unless stated otherwise.
         /// \endakwarning
         /// \sa
         /// - \ref source_control_dll_creation_object_information
         class ISourceControl
         {
         public: 
             
             /// \name Enumeration types
             //@{
  
             /// Operation result. Some interface functions need to return the result of the operation. This is used
             /// by Wwise to manage various errors.
             enum OperationResult
             {
                 OperationResult_Succeed = 0,    ///
                 OperationResult_Failed,         ///
                 OperationResult_TimedOut,       ///
                 OperationResult_Cancelled,      ///
                 OperationResult_NotImplemented  ///
             };
  
             /// Menu type. The operation list may vary depending on the location where a menu containing operations 
             /// needs to be displayed.
             enum OperationMenuType
             {
                 OperationMenuType_WorkUnits = 0,///
                 OperationMenuType_Sources,      ///
                 OperationMenuType_Generated,    ///
                 OperationMenuType_Explorer      ///
             };
  
             /// Pre/PostCreateOrModify Operation flags. These flags represent the operation(s) performed on files.
             enum CreateOrModifyOperation
             {
                 CreateOrModifyOperation_Create = 1 ///
                 CreateOrModifyOperation_Modify = 1 ///
             };
  
             /// The operation's effect on the file(s) involved.
             enum OperationEffect
             {
                 OperationEffect_LocalContentModification = 1 ///
                 OperationEffect_ServerContentModification = 1 ///
             };
  
             //@}
  
             /// The base interface for operations that return information to Wwise
             class IOperationResult
             {
             public:
                 /// Returns OperationResult_Succeed or OperationResult_Failed
                 virtual OperationResult GetOperationResult() = 0;
  
                 /// Implementations should call "delete this;".
                 virtual void Destroy() = 0;
             };
  
             /// The result returned by DoOperation for a Move, Rename or Delete operation.
             /// An instance of this class is allocated by the plugin and freed by Wwise.
             /// The operation ID must be identified by :
             /// PluginInfo::m_dwMoveCommandID, PluginInfo::m_dwMoveNoUICommandID,
             /// PluginInfo::m_dwRenameCommandID or PluginInfo::m_dwRenameNoUICommandID
             /// PluginInfo::m_dwDeleteCommandID or PluginInfo::m_dwDeleteNoUICommandID
             class IFileOperationResult : public IOperationResult
             {
             public:
                 /// Return the move source and destination for the file at index in_uiIndex
                 virtual void GetMovedFile( 
                     unsigned int in_uiIndex,    ///= 0 and 
                     LPWSTR out_szFrom,          ///
                     LPWSTR out_szTo,            ///
                     unsigned int in_uiArraySize ///
                     ) = 0;
                 
                 /// Return the successful file at index in_uiIndex
                 virtual void GetFile( 
                     unsigned int in_uiIndex,    ///= 0 and 
                     LPWSTR out_szPath,          ///
                     unsigned int in_uiArraySize ///
                     ) = 0;
  
                 /// Returns how many files were moved during the operation
                 virtual unsigned int GetFileCount() = 0;
             };
  
             /// 'Filename to Status' map item. This is the type used in the AK::Wwise::ISourceControl::FilenameToStatusMap 
             /// SourceControlContainers::IAkMap template parameter structure.
             struct FilenameToStatusMapItem
             {
                 BSTR m_bstrStatus;              ///
                 BSTR m_bstrOwner;               ///
             };
  
             /// Operation list item. This is the type used in the AK::Wwise::ISourceControl::OperationList SourceControlContainers::IAkList template class.
             struct OperationListItem
             {
                 DWORD m_dwOperationID;          ///
                 bool m_bEnabled;                ///
             };
  
             /// FilenameToIconMap item. This is the type used to display the file status icon and tool tip text 
             /// in the Project Explorer.
             struct FilenameToIconMapItem
             {
                 HICON m_hIcon;                  ///
                 BSTR m_bstrToolTip;             ///
             };
  
             /// \name List types
             //@{
  
             /// String List. When Wwise needs to pass a file name list, it gives this container to the plug-in.
             /// \sa
             /// - AK::Wwise::SourceControlContainers::IAkList
             typedef SourceControlContainers::IAkList StringList;
             
             /// Boolean List. When Wwise needs to pass a boolean list, it gives this container to the plug-in.
             /// \sa
             /// - AK::Wwise::SourceControlContainers::IAkList
             typedef SourceControlContainers::IAkList BooleanList;
             
             /// Plug-in ID list. When Wwise needs to have the list of plug-ins that a DLL contains, it requests
             /// the list of plug-in IDs using a function exported by the DLL.
             typedef SourceControlContainers::IAkList PluginIDList;
  
             /// When Wwise needs to have the list of operations that are available in a certain context, it requests
             /// the list of operations using this list type. The contexts are determined by the AK::Wwise::ISourceControl::OperationMenuType
             /// enumeration type.
             /// \sa
             /// - AK::Wwise::ISourceControl::OperationListItem
             /// - AK::Wwise::SourceControlContainers::IAkList
             typedef SourceControlContainers::IAkList OperationList;
  
             //@}
  
             /// \name Map types
             //@{
  
             /// The AK:Wwise::ISourceControl interface offers a way to display custom icons in the Project Explorer. This map
             /// type must be filled in by the plug-in when Wwise gives it a file name list. CStringW objects are used as keys, and are associated
             /// to FilenameToIconMapItem objects. The HICON m_hIcon member will be NULL when there is no icon associated with the file.
             /// \sa
             /// - AK::Wwise::SourceControlContainers::IAkMap
             typedef SourceControlContainers::IAkMap FilenameToIconMap;
         
             /// When the File Manager needs to fill in the 'Status' and 'Owners' columns of work units or source lists,
             /// the plug-in needs to fill in this map with the corresponding text. File names are used as keys, and are associated
             /// to the text to be displayed in the 'Status' and 'Owners' columns.
             /// \sa
             /// - AK::Wwise::ISourceControl::FilenameToStatusMapItem
             /// - AK::Wwise::SourceControlContainers::IAkMap
             typedef SourceControlContainers::IAkMap FilenameToStatusMap;
  
             //@}
  
             typedef SourceControlContainers::IAkMap IConnectParameterMap;
  
             /// Plug-in information structure. This structure gives a simple overview of the plug-in's capabilities.
             class PluginInfo
             {
             public:
                 BSTR m_bstrName;                ///
                 unsigned int m_uiVersion;       ///
  
                 bool m_bShowConfigDlgAvailable; ///
                 DWORD m_dwUpdateCommandID;      ///
                 DWORD m_dwCommitCommandID;      ///
                 DWORD m_dwRenameCommandID;      ///
                 DWORD m_dwMoveCommandID;        ///
                 DWORD m_dwAddCommandID;         ///
                 DWORD m_dwDeleteCommandID;      ///
                 DWORD m_dwRevertCommandID;      ///
                 DWORD m_dwDiffCommandID;        ///
                 DWORD m_dwCheckOutCommandID;    ///
                 DWORD m_dwRenameNoUICommandID;  ///
                 DWORD m_dwMoveNoUICommandID;    ///
                 DWORD m_dwAddNoUICommandID;     ///
                 DWORD m_dwDeleteNoUICommandID;  ///
                 DWORD m_dwRevertNoUICommandID;  ///
                 DWORD m_dwCheckOutNoUICommandID;///
                 bool m_bStatusIconAvailable;    ///
             };
  
             /// This function is called when the plug-in is initialized after its creation.
             virtual void Init( 
                 AK::Wwise::ISourceControlUtilities* in_pUtilities,  ///
                                                                     ///
                 bool in_bAutoAccept                                 ///
                 ) = 0;
  
             /// This function is called when the plug-in is terminated before its destruction.
             virtual void Term() = 0;
  
             /// This function destroys the plug-in. The implementation is generally '{ delete this; }'.
             virtual void Destroy() = 0;
  
             /// This method connects the source control plugin
             virtual OperationResult Connect(const IConnectParameterMap & parameterMap) = 0;
  
             /// This method disconnects the source control plugin
             virtual OperationResult Disconnect() = 0;
  
             /// This function is called when the user clicks the 'Config...' button in the Project Settings.
             /// \return True if the user accepts the configuration, False otherwise
             /// \sa
             /// - AK::Wwise::ISourceControl::PluginInfo::m_bShowConfigDlgAvailable
             virtual bool ShowConfigDlg() = 0;
  
             /// Gets the operation list to be displayed in a menu.
             /// \return The result of the operation
             virtual AK::Wwise::ISourceControl::OperationResult GetOperationList( 
                 OperationMenuType in_menuType,      ///
                 const StringList& in_rFilenameList, ///
                 OperationList& out_rOperationList   ///
                 ) = 0;
  
             /// Gets the operation name to display in user interface
             // \return A mask of all the applicable OperationEffect enum values
             virtual LPCWSTR GetOperationName(
                 DWORD in_dwOperationID  ///
                 ) = 0;
  
             /// Gets the operation effect on the file(s) involved in the operation.
             // \return A mask of all the applicable OperationEffect enum values
             virtual DWORD GetOperationEffect(
                 DWORD in_dwOperationID  ///
                 ) = 0;
  
             /// Gets the text to be displayed in the 'Status' and 'Owners' columns of the File Manager.
             /// \return The result of the operation
             virtual AK::Wwise::ISourceControl::OperationResult GetFileStatus( 
                 const StringList& in_rFilenameList,     ///
                 FilenameToStatusMap& out_rFileStatusMap,///
                 DWORD in_dwTimeoutMs = INFINITE         ///
                 ) = 0;
  
             /// In a similar way to AK::Wwise::ISourceControl::GetFileStatus(), this function gets the icons to be displayed in the
             /// Project Explorer.
             /// \return The result of the operation
             virtual AK::Wwise::ISourceControl::OperationResult GetFileStatusIcons( 
                 const StringList& in_rFilenameList,     ///
                 FilenameToIconMap& out_rFileIconsMap,   ///
                 DWORD in_dwTimeoutMs = INFINITE         ///
                 ) = 0;
  
             /// Combines GetFileStatus() and GetFileStatusIcons() to get the source control file icons and the text to be displayed in the 'Status' and 'Owners'
             /// columns of the File Manager.
             /// \return The result of the operation
             virtual AK::Wwise::ISourceControl::OperationResult GetFileStatusAndIcons( 
                 const StringList& in_rFilenameList,     ///
                 FilenameToStatusMap& out_rFileStatusMap,///
                 FilenameToIconMap& out_rFileIconsMap,   ///
                 DWORD in_dwTimeoutMs = INFINITE         ///
                 ) = 0;
  
             /// Gets the files that should be displayed in the File Manager file list, but that are not on the local disk.
             /// Deleted files that need to be submitted to the server are an example of implementation.
             /// \return The result of the operation
             virtual AK::Wwise::ISourceControl::OperationResult GetMissingFilesInDirectories( 
                 const StringList& in_rDirectoryList,    ///
                 StringList& out_rFilenameList           ///
                 ) = 0;
  
             /// Performs an operation on files. This function is called when the user clicks on a source control operation in a menu.
             /// The returned IOperationResult must be allocated on the heap and freed by the caller using IOperationResult::Destroy.
             /// For Rename and Move operations in No-User-Interface mode, in_pTargetFilenameList contains the list of target names are known in advance.
             [[nodiscard]] virtual IOperationResult* DoOperation( 
                 DWORD in_dwOperationID,                         ///
                 const StringList& in_rFilenameList,             ///
                 const StringList* in_pTargetFilenameList = NULL ///
                 ) = 0;
  
             /// This method is called when the user adds files to the project (Work Units or Sources), saves the project, 
             /// or triggers any call to a Wwise operation that could alter source control files. It is called before Wwise performs
             /// the operation and is always followed by a call to PostCreateOrModify.
             /// \return The result of the operation 
             virtual AK::Wwise::ISourceControl::OperationResult PreCreateOrModify(
                 const StringList& in_rFilenameList,     ///
                 CreateOrModifyOperation in_eOperation,  ///
                 bool& out_rContinue                     ///
                 ) = 0;
  
             /// This method is called when the user adds files to the project (Work Units or Sources), saves the project, 
             /// or triggers any call to a Wwise operation that could alter source control files. It is called after Wwise performs 
             /// the operation and is always preceded by a call to PreCreateOrModify.
             /// \return The result of the operation
             virtual AK::Wwise::ISourceControl::OperationResult PostCreateOrModify(
                 const StringList& in_rFilenameList,     ///
                 CreateOrModifyOperation in_eOperation,  ///
                 bool& out_rContinue                     ///
                 ) = 0;
  
             /// This methods returns the list files that can be committed
             /// \return The result of the operation 
             virtual AK::Wwise::ISourceControl::OperationResult GetFilesForOperation( 
                 DWORD in_dwOperationID,                     ///
                 const StringList& in_rFilenameList,         ///
                 StringList& out_rFilenameList,              ///
                 FilenameToStatusMap& out_rFileStatusMap     ///
                 ) = 0;
  
             /// This methods returns whether the specified operation can be applied to each file.
             /// \return The result of the operation 
             virtual AK::Wwise::ISourceControl::OperationResult CheckFilesForOperation( 
                 DWORD in_dwOperationID,                     ///
                 const StringList& in_rFilenameList,         ///
                 BooleanList& out_rFileStatusList            ///
                 ) = 0;
  
             /// This methods returns a boolean for each file, indicating whether the file is under source control.
             /// \return The result of the operation 
             virtual AK::Wwise::ISourceControl::OperationResult FilesUnderSourceControl( 
                 const StringList& in_rFilenameList,         ///
                 BooleanList& out_rFileStatusList            ///
                 ) = 0;
  
             //@}
  
             /// \name Exported functions prototypes
             //@{
  
             /// Gets the plug-in ID list contained by the DLL file.
             typedef void (__stdcall* GetSourceControlIDListFuncPtr)( 
                 PluginIDList& out_rPluginIDList     ///
                 );
  
             /// Gets the AK::Wwise::ISourceControl::PluginInfo class associated with a given plug-in ID.
             typedef void (__stdcall* GetSourceControlPluginInfoFuncPtr)( 
                 const GUID& in_rguidPluginID,       ///
                 PluginInfo& out_rPluginInfo         ///
                 );
  
             /// Gets an instance of a plug-in.
             /// \return A pointer to an AK::Wwise::ISourceControl instance
             typedef ISourceControl* (__stdcall* GetSourceControlInstanceFuncPtr)( 
                 const GUID& in_guidPluginID         ///
                 );
         };
     }
 }
  
 #endif // _AK_WWISE_ISOURCECONTROL_H

AK.Wwise::ISourceControl::GetFileStatusIcons

virtual AK::Wwise::ISourceControl::OperationResult GetFileStatusIcons(const StringList &in_rFilenameList, FilenameToIconMap &out_rFileIconsMap, DWORD in_dwTimeoutMs=INFINITE)=0

AK.Wwise::ISourceControl::FilenameToStatusMapItem::m_bstrStatus

BSTR m_bstrStatus

Text displayed in the File Manager's 'Status' column.

Definition: ISourceControl.h:151

AK.Wwise::ISourceControl::OperationMenuType_Explorer

@ OperationMenuType_Explorer

The menu is displayed in the Project Explorer.

Definition: ISourceControl.h:89

AK.Wwise::ISourceControl::OperationEffect_LocalContentModification

@ OperationEffect_LocalContentModification

The operation will modify the local content of the file.

Definition: ISourceControl.h:102

Audiokinetic namespace.

Definition: AkWwiseSDKVersion.cs:31

AK.Wwise::SourceControlContainers::IAkList

Definition: SourceControlContainers.h:60

AK.Wwise::ISourceControl::GetMissingFilesInDirectories

virtual AK::Wwise::ISourceControl::OperationResult GetMissingFilesInDirectories(const StringList &in_rDirectoryList, StringList &out_rFilenameList)=0

AK.Wwise::ISourceControl::PluginInfo::m_dwRenameCommandID

DWORD m_dwRenameCommandID

Indicates the command ID for the Rename command, s_dwInvalidOperationID (-1) if not supported.

Definition: ISourceControl.h:229

AK.Wwise::SourceControlContainers::IAkMap

Definition: SourceControlContainers.h:127

AK.Wwise::ISourceControl::StringList

SourceControlContainers::IAkList StringList

Definition: ISourceControl.h:176

AK.Wwise::ISourceControl::FilenameToIconMapItem::m_hIcon

HICON m_hIcon

A handle to an icon that will be displayed in the Project Explorer.

Definition: ISourceControl.h:166

AK.Wwise::ISourceControl::PluginInfo::m_dwAddCommandID

DWORD m_dwAddCommandID

Indicates the command ID for the Add command, s_dwInvalidOperationID (-1) if not supported.

Definition: ISourceControl.h:231

AK.Wwise::ISourceControl::OperationMenuType_Sources

@ OperationMenuType_Sources

The menu is displayed in the File Manager's 'Sources' tab.

Definition: ISourceControl.h:87

AK.Wwise::ISourceControl::FilenameToIconMapItem::m_bstrToolTip

BSTR m_bstrToolTip

The tool tip text that will be displayed when the user mouses over the icon.

Definition: ISourceControl.h:167

AK.Wwise::ISourceControl::GetOperationEffect

virtual DWORD GetOperationEffect(DWORD in_dwOperationID)=0

Gets the operation effect on the file(s) involved in the operation.

AK.Wwise::ISourceControl::Init

virtual void Init(AK::Wwise::ISourceControlUtilities *in_pUtilities, bool in_bAutoAccept)=0

This function is called when the plug-in is initialized after its creation.

AK.Wwise::ISourceControl::FilenameToStatusMapItem::m_bstrOwner

BSTR m_bstrOwner

Text displayed in the File Manager's 'Owners' column.

Definition: ISourceControl.h:152

AK.Wwise::ISourceControl::OperationResult_TimedOut

@ OperationResult_TimedOut

The operation timed out.

Definition: ISourceControl.h:77

AK.Wwise::ISourceControl::BooleanList

SourceControlContainers::IAkList BooleanList

Definition: ISourceControl.h:181

AK.Wwise::ISourceControl::FilenameToStatusMap

SourceControlContainers::IAkMap FilenameToStatusMap

Definition: ISourceControl.h:213

AK.Wwise::ISourceControl::PluginInfo::m_bShowConfigDlgAvailable

bool m_bShowConfigDlgAvailable

Used to enable/disable the 'Config...' button in the Project Settings.

Definition: ISourceControl.h:226

AK.Wwise::ISourceControl::PluginInfo::m_dwDeleteNoUICommandID

DWORD m_dwDeleteNoUICommandID

Indicates the command ID for the Delete command, showing no User Interface, s_dwInvalidOperationID (-...

Definition: ISourceControl.h:239

AK.Wwise::ISourceControl::OperationMenuType_WorkUnits

@ OperationMenuType_WorkUnits

The menu is displayed in the File Manager's 'Work Units' tab.

Definition: ISourceControl.h:86

AK.Wwise::ISourceControl::Destroy

virtual void Destroy()=0

This function destroys the plug-in. The implementation is generally '{ delete this; }'.

AK.Wwise::ISourceControl::FilenameToStatusMapItem

Definition: ISourceControl.h:150

AK.Wwise::ISourceControl::PluginInfo::m_dwDiffCommandID

DWORD m_dwDiffCommandID

Indicates the command ID for the Diff command, s_dwInvalidOperationID (-1) if not supported.

Definition: ISourceControl.h:234

AK.Wwise::ISourceControl::OperationResult_Succeed

@ OperationResult_Succeed

The operation succeeded.

Definition: ISourceControl.h:75

AK.Wwise::ISourceControl::OperationResult_NotImplemented

@ OperationResult_NotImplemented

The operation is not implemented.

Definition: ISourceControl.h:79

AK.Wwise::ISourceControl::GetFileStatus

virtual AK::Wwise::ISourceControl::OperationResult GetFileStatus(const StringList &in_rFilenameList, FilenameToStatusMap &out_rFileStatusMap, DWORD in_dwTimeoutMs=INFINITE)=0

SourceControlContainers.h

Wwise source control containers interface that is used to pass data containers (list and map) in para...

NULL

#define NULL

Definition: AkTypes.h:46

AK.Wwise::SourceControlConstant

This class contains static constants that can be useful to the plug-in.

Definition: ISourceControl.h:49

AK.Wwise::ISourceControl::DoOperation

virtual IOperationResult * DoOperation(DWORD in_dwOperationID, const StringList &in_rFilenameList, const StringList *in_pTargetFilenameList=NULL)=0

AK.Wwise::ISourceControl::OperationMenuType_Generated

@ OperationMenuType_Generated

The menu is displayed in the File Manager's 'Generated' tab.

Definition: ISourceControl.h:88

AK.Wwise::ISourceControl::PreCreateOrModify

virtual AK::Wwise::ISourceControl::OperationResult PreCreateOrModify(const StringList &in_rFilenameList, CreateOrModifyOperation in_eOperation, bool &out_rContinue)=0

AK.Wwise::ISourceControl::PluginInfo::m_dwRenameNoUICommandID

DWORD m_dwRenameNoUICommandID

Indicates the command ID for the Rename command, showing no User Interface, s_dwInvalidOperationID (-...

Definition: ISourceControl.h:236

AK.Wwise::ISourceControl::GetOperationName

virtual LPCWSTR GetOperationName(DWORD in_dwOperationID)=0

Gets the operation name to display in user interface.

AK.Wwise::ISourceControl::IOperationResult::Destroy

virtual void Destroy()=0

Implementations should call "delete this;".

ISourceControlUtilities.h

AK.Wwise::ISourceControlUtilities

Definition: ISourceControlUtilities.h:49

AK.Wwise::ISourceControl::IFileOperationResult::GetMovedFile

virtual void GetMovedFile(unsigned int in_uiIndex, LPWSTR out_szFrom, LPWSTR out_szTo, unsigned int in_uiArraySize)=0

Return the move source and destination for the file at index in_uiIndex.

AK.Wwise::ISourceControl::PluginInfo::m_dwCommitCommandID

DWORD m_dwCommitCommandID

Indicates the command ID for the Commit/Submit/Checkin command, s_dwInvalidOperationID (-1) if not su...

Definition: ISourceControl.h:228

AK.Wwise::ISourceControl::Disconnect

virtual OperationResult Disconnect()=0

This method disconnects the source control plugin.

AK.Wwise::ISourceControl::PluginInfo::m_dwAddNoUICommandID

DWORD m_dwAddNoUICommandID

Indicates the command ID for the Add command, showing no User Interface, s_dwInvalidOperationID (-1) ...

Definition: ISourceControl.h:238

AK.Wwise::ISourceControl::IFileOperationResult

Definition: ISourceControl.h:126

AK.Wwise::ISourceControl::OperationListItem

Operation list item. This is the type used in the AK::Wwise::ISourceControl::OperationList SourceCont...

Definition: ISourceControl.h:157

AK.Wwise::ISourceControl::PluginInfo::m_dwUpdateCommandID

DWORD m_dwUpdateCommandID

Indicates the command ID for the Update command, s_dwInvalidOperationID (-1) if not supported.

Definition: ISourceControl.h:227

AK.Wwise::ISourceControl::OperationEffect

OperationEffect

The operation's effect on the file(s) involved.

Definition: ISourceControl.h:101

AK.Wwise::ISourceControl::OperationResult

OperationResult

Definition: ISourceControl.h:74

AK.Wwise::ISourceControl::PluginInfo::m_dwCheckOutCommandID

DWORD m_dwCheckOutCommandID

Indicates the command ID for the CheckOut command, s_dwInvalidOperationID (-1) if not supported.

Definition: ISourceControl.h:235

AK.Wwise::ISourceControl::GetFileStatusAndIcons

virtual AK::Wwise::ISourceControl::OperationResult GetFileStatusAndIcons(const StringList &in_rFilenameList, FilenameToStatusMap &out_rFileStatusMap, FilenameToIconMap &out_rFileIconsMap, DWORD in_dwTimeoutMs=INFINITE)=0

AK.Wwise::ISourceControl::GetSourceControlInstanceFuncPtr

ISourceControl *(__stdcall * GetSourceControlInstanceFuncPtr)(const GUID &in_guidPluginID)

Definition: ISourceControl.h:396

AK.Wwise::ISourceControl::PluginInfo::m_dwCheckOutNoUICommandID

DWORD m_dwCheckOutNoUICommandID

Indicates the command ID for the CheckOut command, showing no User Interface, s_dwInvalidOperationID ...

Definition: ISourceControl.h:241

AK.Wwise::ISourceControl::PluginInfo::m_dwMoveNoUICommandID

DWORD m_dwMoveNoUICommandID

Indicates the command ID for the Move command, showing no User Interface, s_dwInvalidOperationID (-1)...

Definition: ISourceControl.h:237

AK.Wwise::ISourceControl::CreateOrModifyOperation_Create

@ CreateOrModifyOperation_Create

Files will be created during the operation.

Definition: ISourceControl.h:95

AK.Wwise::ISourceControl::IFileOperationResult::GetFileCount

virtual unsigned int GetFileCount()=0

Returns how many files were moved during the operation.

AK.Wwise::ISourceControl::OperationResult_Failed

@ OperationResult_Failed

The operation failed.

Definition: ISourceControl.h:76

AK.Wwise::ISourceControl::Connect

virtual OperationResult Connect(const IConnectParameterMap &parameterMap)=0

This method connects the source control plugin.

AK.Wwise::ISourceControl::PluginInfo::m_dwMoveCommandID

DWORD m_dwMoveCommandID

Indicates the command ID for the Move command, s_dwInvalidOperationID (-1) if not supported.

Definition: ISourceControl.h:230

AK.Wwise::ISourceControl::FilenameToIconMapItem

Definition: ISourceControl.h:165

AK.Wwise::ISourceControl::PluginIDList

SourceControlContainers::IAkList PluginIDList

Definition: ISourceControl.h:185

AK.Wwise::ISourceControl::PluginInfo::m_dwDeleteCommandID

DWORD m_dwDeleteCommandID

Indicates the command ID for the Delete command, s_dwInvalidOperationID (-1) if not supported.

Definition: ISourceControl.h:232

AK.Wwise::ISourceControl::CheckFilesForOperation

virtual AK::Wwise::ISourceControl::OperationResult CheckFilesForOperation(DWORD in_dwOperationID, const StringList &in_rFilenameList, BooleanList &out_rFileStatusList)=0

AK.Wwise::ISourceControl::PluginInfo::m_bstrName

BSTR m_bstrName

The name of the plug-in displayed in the Project Settings plug-in list.

Definition: ISourceControl.h:223

AK.Wwise::ISourceControl::OperationListItem::m_dwOperationID

DWORD m_dwOperationID

The operation ID.

Definition: ISourceControl.h:158

AK.Wwise::ISourceControl::IOperationResult::GetOperationResult

virtual OperationResult GetOperationResult()=0

Returns OperationResult_Succeed or OperationResult_Failed.

AK.Wwise::ISourceControl::FilenameToIconMap

SourceControlContainers::IAkMap FilenameToIconMap

Definition: ISourceControl.h:205

AK.Wwise::ISourceControl::OperationResult_Cancelled

@ OperationResult_Cancelled

The operation was cancelled.

Definition: ISourceControl.h:78

AK.Wwise::ISourceControl::OperationListItem::m_bEnabled

bool m_bEnabled

True: the operation is enabled in the menu, False: the operation is disabled (grayed out) in the menu...

Definition: ISourceControl.h:159

AK.Wwise::ISourceControl::PluginInfo::m_uiVersion

unsigned int m_uiVersion

The current version of the plug-in.

Definition: ISourceControl.h:224

AK.Wwise::ISourceControl::GetFilesForOperation

virtual AK::Wwise::ISourceControl::OperationResult GetFilesForOperation(DWORD in_dwOperationID, const StringList &in_rFilenameList, StringList &out_rFilenameList, FilenameToStatusMap &out_rFileStatusMap)=0

AK.Wwise::ISourceControl::CreateOrModifyOperation_Modify

@ CreateOrModifyOperation_Modify

Files will be modified during the operation.

Definition: ISourceControl.h:96

AK.Wwise::ISourceControl::CreateOrModifyOperation

CreateOrModifyOperation

Pre/PostCreateOrModify Operation flags. These flags represent the operation(s) performed on files.

Definition: ISourceControl.h:94

AK.Wwise::ISourceControl::PluginInfo::m_dwRevertNoUICommandID

DWORD m_dwRevertNoUICommandID

Indicates the command ID for the Revert command, showing no User Interface, s_dwInvalidOperationID (-...

Definition: ISourceControl.h:240

AK.Wwise::SourceControlConstant::s_dwInvalidOperationID

static const DWORD s_dwInvalidOperationID

Invalid operation ID (MUST NOT BE USED as an operation ID in OperationListItem)

Definition: ISourceControl.h:54

AK.Wwise::ISourceControl::PostCreateOrModify

virtual AK::Wwise::ISourceControl::OperationResult PostCreateOrModify(const StringList &in_rFilenameList, CreateOrModifyOperation in_eOperation, bool &out_rContinue)=0

AK.Wwise::ISourceControl::PluginInfo

Plug-in information structure. This structure gives a simple overview of the plug-in's capabilities.

Definition: ISourceControl.h:221

AK.Wwise::ISourceControl::OperationEffect_ServerContentModification

@ OperationEffect_ServerContentModification

The operation will modify the remote content (on the server) of the file.

Definition: ISourceControl.h:103

AK.Wwise::ISourceControl::OperationList

SourceControlContainers::IAkList OperationList

Definition: ISourceControl.h:193

AK.Wwise::ISourceControl::GetOperationList

virtual AK::Wwise::ISourceControl::OperationResult GetOperationList(OperationMenuType in_menuType, const StringList &in_rFilenameList, OperationList &out_rOperationList)=0

AK.Wwise::ISourceControl::FilesUnderSourceControl

virtual AK::Wwise::ISourceControl::OperationResult FilesUnderSourceControl(const StringList &in_rFilenameList, BooleanList &out_rFileStatusList)=0

AK.Wwise::ISourceControl::PluginInfo::m_bStatusIconAvailable

bool m_bStatusIconAvailable

Indicates that the plug-in supports Project Explorer custom icons.

Definition: ISourceControl.h:242

AK.Wwise::ISourceControl::IConnectParameterMap

SourceControlContainers::IAkMap IConnectParameterMap

Definition: ISourceControl.h:217

AK.Wwise::ISourceControl::IOperationResult

The base interface for operations that return information to Wwise.

Definition: ISourceControl.h:110

AK.Wwise::ISourceControl

Definition: ISourceControl.h:65

AK.Wwise::SourceControlConstant::s_uiMaxWorkUnitName

static const unsigned int s_uiMaxWorkUnitName

Maximum length that a work unit name can be.

Definition: ISourceControl.h:52

AK.Wwise::ISourceControl::Term

virtual void Term()=0

This function is called when the plug-in is terminated before its destruction.

AK.Wwise::ISourceControl::IFileOperationResult::GetFile

virtual void GetFile(unsigned int in_uiIndex, LPWSTR out_szPath, unsigned int in_uiArraySize)=0

Return the successful file at index in_uiIndex.

AK.Wwise::ISourceControl::GetSourceControlPluginInfoFuncPtr

void(__stdcall * GetSourceControlPluginInfoFuncPtr)(const GUID &in_rguidPluginID, PluginInfo &out_rPluginInfo)

Gets the AK::Wwise::ISourceControl::PluginInfo class associated with a given plug-in ID.

Definition: ISourceControl.h:389

AK.Wwise::ISourceControl::GetSourceControlIDListFuncPtr

void(__stdcall * GetSourceControlIDListFuncPtr)(PluginIDList &out_rPluginIDList)

Gets the plug-in ID list contained by the DLL file.

Definition: ISourceControl.h:384

GUID

Definition: PluginHelpers.h:45

AK.Wwise::ISourceControl::OperationMenuType

OperationMenuType

Definition: ISourceControl.h:85

AK.Wwise::ISourceControl::ShowConfigDlg

virtual bool ShowConfigDlg()=0

AK.Wwise::ISourceControl::PluginInfo::m_dwRevertCommandID

DWORD m_dwRevertCommandID

Indicates the command ID for the Revert command, s_dwInvalidOperationID (-1) if not supported.

Definition: ISourceControl.h:233

Cette page a-t-elle été utile ?

Besoin d'aide ?

Des questions ? Des problèmes ? Besoin de plus d'informations ? Contactez-nous, nous pouvons vous aider !

Visitez notre page d'Aide

Décrivez-nous de votre projet. Nous sommes là pour vous aider.

Enregistrez votre projet et nous vous aiderons à démarrer sans aucune obligation !

Partir du bon pied avec Wwise