Grænseflade til at oprette en ny Steam-forekomst eller til at oprette forbindelse til en eksisterende Steam-forekomst, uanset om det er i en anden proces eller lokalt.
I de fleste scenarier håndteres dette automatisk via
SteamAPI_Init.
Du skal kun bruge disse API'er, hvis du har et mere komplekst versionsprogram, eller hvis du ønsker at implementere en multiplekseret spilserver, hvor en enkelt proces håndterer flere spil på en gang med uafhængige spilserver-Steam-ID'er.
Medlemsfunktioner
Medlemsfunktioner for
ISteamClient
kaldes gennem den globale accessor-funktion
SteamClient()
.
BReleaseSteamPipe
bool BReleaseSteamPipe( HSteamPipe hSteamPipe );
Navn | Type | Beskrivelse |
hSteamPipe | HSteamPipe | Pipen, som skal frigives. |
Frigiver en tidligere oprettet kommunikations-pipe.
IKKE TRÅDSIKKER – sørg for, at ingen andre tråde tilgår Steamworks-API, når funktionen kaldes!
Returværdier: bool
true – hvis pipen var gyldig, og udgivelsen blev fuldført, ellers returneres
false.
BShutdownIfAllPipesClosed
bool BShutdownIfAllPipesClosed();
Udløser global lukning af DLL, hvis alle pipes er lukkede.
Returværdier: bool
ConnectToGlobalUser
HSteamUser ConnectToGlobalUser( HSteamPipe hSteamPipe );
Navn | Type | Beskrivelse |
hSteamPipe | HSteamPipe | Forbindelsespipen, som der skal forbindes med. |
Opretter forbindelse til en eksisterende global bruger – fejler, hvis der ikke er en.
Bruges af spillet til at koordinere med Steam-brugergrænsefladen.
IKKE TRÅDSIKKER – sørg for, at ingen andre tråde tilgår Steamworks-API, når funktionen kaldes!
Returværdier: HSteamUserHSteamUser-handlet tilhørende den globale bruger. Returnerer 0 ved fejl, hvis pipen er ugyldig, eller der ikke er nogen global bruger.
CreateLocalUser
HSteamUser CreateLocalUser( HSteamPipe *phSteamPipe, EAccountType eAccountType );
Opret en Steam-bruger, som ikke deles med nogen andre. Bruges kun af spilservere.
IKKE TRÅDSIKKER – sørg for, at ingen andre tråde tilgår Steamworks-API, når funktionen kaldes!
Returværdier: HSteamUserEt nyt handle til en SteamUser.
CreateSteamPipe
HSteamPipe CreateSteamPipe();
Opretter en kommunikationspipe til Steam-klienten.
IKKE TRÅDSIKKER – sørg for, at ingen andre tråde tilgår Steamworks-API, når funktionen kaldes
Returværdier: HSteamPipeGetIPCCallCount
uint32 GetIPCCallCount();
Returnerer antallet af IPC-kald (Inter-Process Communication), som er foretaget siden sidste gang, denne funktion blev kaldt.
Bruges til ydelsesfejlfinding, så du kan forstå, hvor mange IPC-kald dit spil laver pr. billede. Hvert IPC-opkald er mindst et trådkontekstskift, hvis ikke det er et processkift, så du skal være grundig og muligvis vurdere, hvor ofte du vil udføre dem.
Returværdier: uint32GetISteamApps
ISteamApps * GetISteamApps( HSteamUser hSteamUser, HSteamPipe hSteamPipe, const char *pchVersion );
Navn | Type | Beskrivelse |
hSteamUser | HSteamUser | Bruger-handle, som grænsefladen hentes fra. |
hSteamPipe | HSteamPipe | Pipen, som grænsefladen skal tilgås gennem. |
pchVersion | const char * | Versionsstrengen, som identificerer versionen af grænsefladen, du modtager. |
Henter
ISteamApps-grænsefladen tilknyttet det specifikke bruger-handle.
En konstant, som indeholder den aktuelle version af grænsefladen, er: "STEAMAPPLIST_INTERFACE_VERSION"
Det bør aldrig være nødvendigt at bruge dette under normale forhold. Det er normalt funktionelt svarende til at kalde den globale accessor:
SteamAppst()
Returværdier: ISteamApps *
En pointer til implementeringen af SteamApps tilknyttet den givne HSteamUser.
Returnerer NULL, hvis nogen af argumenterne er ugyldige.
GetISteamController
ISteamController * GetISteamController( HSteamUser hSteamUser, HSteamPipe hSteamPipe, const char *pchVersion );
Navn | Type | Beskrivelse |
hSteamUser | HSteamUser | Bruger-handle, som grænsefladen hentes fra. |
hSteamPipe | HSteamPipe | Pipen, som grænsefladen skal tilgås gennem. |
pchVersion | const char * | Versionsstrengen, som identificerer versionen af grænsefladen, du modtager. |
Henter
ISteamController-grænsefladen tilknyttet det specifikke bruger-handle.
En konstant, som indeholder den aktuelle version af grænsefladen, er: "STEAMCONTROLLER_INTERFACE_VERSION"
Det bør aldrig være nødvendigt at bruge dette under normale forhold. Det er normalt funktionelt svarende til at kalde den globale accessor:
SteamController()
Returværdier: ISteamController *
En pointer til implementeringen af SteamController tilknyttet den givne HSteamUser.
Returnerer NULL, hvis nogen af argumenterne er ugyldige.
GetISteamFriends
ISteamFriends * GetISteamFriends( HSteamUser hSteamUser, HSteamPipe hSteamPipe, const char *pchVersion );
Navn | Type | Beskrivelse |
hSteamUser | HSteamUser | Bruger-handle, som grænsefladen hentes fra. |
hSteamPipe | HSteamPipe | Pipen, som grænsefladen skal tilgås gennem. |
pchVersion | const char * | Versionsstrengen, som identificerer versionen af grænsefladen, du modtager. |
Henter
ISteamFriends-grænsefladen tilknyttet det specifikke bruger-handle.
En konstant, som indeholder den aktuelle version af grænsefladen, er: "STEAMFRIENDS_INTERFACE_VERSION"
Det bør aldrig være nødvendigt at bruge dette under normale forhold. Det er normalt funktionelt svarende til at kalde den globale accessor:
SteamFriends()
Returværdier: ISteamFriends *
En pointer til implementeringen af SteamFriends tilknyttet den givne HSteamUser.
Returnerer NULL, hvis nogen af argumenterne er ugyldige.
GetISteamGameServer
ISteamGameServer * GetISteamGameServer( HSteamUser hSteamUser, HSteamPipe hSteamPipe, const char *pchVersion );
Navn | Type | Beskrivelse |
hSteamUser | HSteamUser | Bruger-handle, som grænsefladen hentes fra. |
hSteamPipe | HSteamPipe | Pipen, som grænsefladen skal tilgås gennem. |
pchVersion | const char * | Versionsstrengen, som identificerer versionen af grænsefladen, du modtager. |
Henter
ISteamGameServer-grænsefladen tilknyttet det specifikke bruger-handle.
En konstant, som indeholder den aktuelle version af grænsefladen, er: "STEAMGAMESERVER_INTERFACE_VERSION"
Det bør aldrig være nødvendigt at bruge dette under normale forhold. Det er normalt funktionelt svarende til at kalde den globale accessor:
SteamGameServer()
Returværdier: ISteamGameServer *
En pointer til implementeringen af SteamGameServer tilknyttet den givne HSteamUser.
Returnerer NULL, hvis nogen af argumenterne er ugyldige.
GetISteamGameServerStats
ISteamGameServerStats * GetISteamGameServerStats( HSteamUser hSteamUser, HSteamPipe hSteamPipe, const char *pchVersion );
Navn | Type | Beskrivelse |
hSteamUser | HSteamUser | Bruger-handle, som grænsefladen hentes fra. |
hSteamPipe | HSteamPipe | Pipen, som grænsefladen skal tilgås gennem. |
pchVersion | const char * | Versionsstrengen, som identificerer versionen af grænsefladen, du modtager. |
Henter
ISteamGameServerStats-grænsefladen tilknyttet det specifikke bruger-handle.
En konstant, som indeholder den aktuelle version af grænsefladen, er: "STEAMGAMESERVERSTATS_INTERFACE_VERSION"
Det bør aldrig være nødvendigt at bruge dette under normale forhold. Det er normalt funktionelt svarende til at kalde den globale accessor:
SteamGameServerStats()
Returværdier: ISteamGameServerStats *
En pointer til implementeringen af SteamGameServerStats tilknyttet den givne HSteamUser.
Returnerer NULL, hvis nogen af argumenterne er ugyldige.
GetISteamGenericInterface
void * GetISteamGenericInterface( HSteamUser hSteamUser, HSteamPipe hSteamPipe, const char *pchVersion );
Navn | Type | Beskrivelse |
hSteamUser | HSteamUser | Bruger-handle, som grænsefladen hentes fra. |
hSteamPipe | HSteamPipe | Pipen, som grænsefladen skal tilgås gennem. |
pchVersion | const char * | Versionsstrengen, som identificerer versionen af grænsefladen, du modtager. |
Henter en generisk grænseflade tilknyttet et bruger-handle.
Du bør aldrig bruge dette under normale forhold.
Returværdier: void *
En pointer til implementeringen af en grænseflade tilknyttet den givne HSteamUser.
Returnerer NULL, hvis nogen af argumenterne er ugyldige.
GetISteamHTMLSurface
ISteamHTMLSurface * GetISteamHTMLSurface( HSteamUser hSteamUser, HSteamPipe hSteamPipe, const char *pchVersion );
Navn | Type | Beskrivelse |
hSteamUser | HSteamUser | Bruger-handle, som grænsefladen hentes fra. |
hSteamPipe | HSteamPipe | Pipen, som grænsefladen skal tilgås gennem. |
pchVersion | const char * | Versionsstrengen, som identificerer versionen af grænsefladen, du modtager. |
Henter
ISteamHTMLSurface-grænsefladen tilknyttet det specifikke bruger-handle.
En konstant, som indeholder den aktuelle version af grænsefladen, er: "STEAMHTMLSURFACE_INTERFACE_VERSION"
Det bør aldrig være nødvendigt at bruge dette under normale forhold. Det er normalt funktionelt svarende til at kalde den globale accessor:
SteamHTMLSurface()
Returværdier: ISteamHTMLSurface *
En pointer til implementeringen af SteamHTMLSurface tilknyttet den givne HSteamUser.
Returnerer NULL, hvis nogen af argumenterne er ugyldige.
GetISteamHTTP
ISteamHTTP * GetISteamHTTP( HSteamUser hSteamUser, HSteamPipe hSteamPipe, const char *pchVersion );
Navn | Type | Beskrivelse |
hSteamUser | HSteamUser | Bruger-handle, som grænsefladen hentes fra. |
hSteamPipe | HSteamPipe | Pipen, som grænsefladen skal tilgås gennem. |
pchVersion | const char * | Versionsstrengen, som identificerer versionen af grænsefladen, du modtager. |
Henter
ISteamHTTP-grænsefladen tilknyttet det specifikke bruger-handle.
En konstant, som indeholder den aktuelle version af grænsefladen, er: "STEAMHTTP_INTERFACE_VERSION"
Det bør aldrig være nødvendigt at bruge dette under normale forhold. Det er normalt funktionelt svarende til at kalde den globale accessor:
SteamHTTP()
Returværdier: ISteamHTTP *
En pointer til implementeringen af SteamHTTP tilknyttet den givne HSteamUser.
Returnerer NULL, hvis nogen af argumenterne er ugyldige.
GetISteamInventory
ISteamInventory * GetISteamInventory( HSteamUser hSteamUser, HSteamPipe hSteamPipe, const char *pchVersion );
Navn | Type | Beskrivelse |
hSteamUser | HSteamUser | Bruger-handle, som grænsefladen hentes fra. |
hSteamPipe | HSteamPipe | Pipen, som grænsefladen skal tilgås gennem. |
pchVersion | const char * | Versionsstrengen, som identificerer versionen af grænsefladen, du modtager. |
Henter
ISteamInventory-grænsefladen tilknyttet det specifikke bruger-handle.
En konstant, som indeholder den aktuelle version af grænsefladen, er: "STEAMINVENTORY_INTERFACE_VERSION"
Det bør aldrig være nødvendigt at bruge dette under normale forhold. Det er normalt funktionelt svarende til at kalde den globale accessor:
SteamInventory()
Returværdier: ISteamInventory *
En pointer til implementeringen af SteamInventory tilknyttet den givne HSteamUser.
Returnerer NULL, hvis nogen af argumenterne er ugyldige.
GetISteamMatchmaking
ISteamMatchmaking * GetISteamMatchmaking( HSteamUser hSteamUser, HSteamPipe hSteamPipe, const char *pchVersion );
Navn | Type | Beskrivelse |
hSteamUser | HSteamUser | Bruger-handle, som grænsefladen hentes fra. |
hSteamPipe | HSteamPipe | Pipen, som grænsefladen skal tilgås gennem. |
pchVersion | const char * | Versionsstrengen, som identificerer versionen af grænsefladen, du modtager. |
Henter
ISteamMatchmaking-grænsefladen tilknyttet det specifikke bruger-handle.
En konstant, som indeholder den aktuelle version af grænsefladen, er: "STEAMMATCHMAKING_INTERFACE_VERSION"
Det bør aldrig være nødvendigt at bruge dette under normale forhold. Det er normalt funktionelt svarende til at kalde den globale accessor:
SteamMatchmaking()
Returværdier: ISteamMatchmaking *
En pointer til implementeringen af SteamMatchmaking tilknyttet den givne HSteamUser.
Returnerer NULL, hvis nogen af argumenterne er ugyldige.
GetISteamMatchmakingServers
ISteamMatchmakingServers * GetISteamMatchmakingServers( HSteamUser hSteamUser, HSteamPipe hSteamPipe, const char *pchVersion );
Navn | Type | Beskrivelse |
hSteamUser | HSteamUser | Bruger-handle, som grænsefladen hentes fra. |
hSteamPipe | HSteamPipe | Pipen, som grænsefladen skal tilgås gennem. |
pchVersion | const char * | Versionsstrengen, som identificerer versionen af grænsefladen, du modtager. |
Henter
ISteamMatchmakingServers-grænsefladen tilknyttet det specifikke bruger-handle.
En konstant, som indeholder den aktuelle version af grænsefladen, er: "STEAMMATCHMAKINGSERVERS_INTERFACE_VERSION"
Det bør aldrig være nødvendigt at bruge dette under normale forhold. Det er normalt funktionelt svarende til at kalde den globale accessor:
SteamMatchmakingServers()
Returværdier: ISteamMatchmakingServers *
En pointer til implementeringen af SteamMatchmakingServers tilknyttet den givne HSteamUser.
Returnerer NULL, hvis nogen af argumenterne er ugyldige.
GetISteamMusic
ISteamMusic * GetISteamMusic( HSteamUser hSteamUser, HSteamPipe hSteamPipe, const char *pchVersion );
Navn | Type | Beskrivelse |
hSteamUser | HSteamUser | Bruger-handle, som grænsefladen hentes fra. |
hSteamPipe | HSteamPipe | Pipen, som grænsefladen skal tilgås gennem. |
pchVersion | const char * | Versionsstrengen, som identificerer versionen af grænsefladen, du modtager. |
Henter
ISteamMusic-grænsefladen tilknyttet det specifikke bruger-handle.
En konstant, som indeholder den aktuelle version af grænsefladen, er: "STEAMMUSIC_INTERFACE_VERSION"
Det bør aldrig være nødvendigt at bruge dette under normale forhold. Det er normalt funktionelt svarende til at kalde den globale accessor:
SteamMusic()
Returværdier: ISteamMusic *
En pointer til implementeringen af SteamMusic tilknyttet den givne HSteamUser.
Returnerer NULL, hvis nogen af argumenterne er ugyldige.
GetISteamMusicRemote
ISteamMusicRemote * GetISteamMusicRemote( HSteamUser hSteamUser, HSteamPipe hSteamPipe, const char *pchVersion );
Navn | Type | Beskrivelse |
hSteamUser | HSteamUser | Bruger-handle, som grænsefladen hentes fra. |
hSteamPipe | HSteamPipe | Pipen, som grænsefladen skal tilgås gennem. |
pchVersion | const char * | Versionsstrengen, som identificerer versionen af grænsefladen, du modtager. |
Henter
ISteamMusicRemote-grænsefladen tilknyttet det specifikke bruger-handle.
En konstant, som indeholder den aktuelle version af grænsefladen, er: "STEAMMUSICREMOTE_INTERFACE_VERSION"
Det bør aldrig være nødvendigt at bruge dette under normale forhold. Det er normalt funktionelt svarende til at kalde den globale accessor:
SteamMusicRemote()
Returværdier: ISteamMusicRemote *
En pointer til implementeringen af SteamMusicRemote tilknyttet den givne HSteamUser.
Returnerer NULL, hvis nogen af argumenterne er ugyldige.
GetISteamNetworking
ISteamNetworking * GetISteamNetworking( HSteamUser hSteamUser, HSteamPipe hSteamPipe, const char *pchVersion );
Navn | Type | Beskrivelse |
hSteamUser | HSteamUser | Bruger-handle, som grænsefladen hentes fra. |
hSteamPipe | HSteamPipe | Pipen, som grænsefladen skal tilgås gennem. |
pchVersion | const char * | Versionsstrengen, som identificerer versionen af grænsefladen, du modtager. |
Henter
ISteamNetworking-grænsefladen tilknyttet det specifikke bruger-handle.
En konstant, som indeholder den aktuelle version af grænsefladen, er: "STEAMNETWORKING_INTERFACE_VERSION"
Det bør aldrig være nødvendigt at bruge dette under normale forhold. Det er normalt funktionelt svarende til at kalde den globale accessor:
SteamNetworking()
Returværdier: ISteamNetworking *
En pointer til implementeringen af SteamNetworking tilknyttet den givne HSteamUser.
Returnerer NULL, hvis nogen af argumenterne er ugyldige.
GetISteamRemoteStorage
ISteamRemoteStorage * GetISteamRemoteStorage( HSteamUser hSteamUser, HSteamPipe hSteamPipe, const char *pchVersion );
Navn | Type | Beskrivelse |
hSteamUser | HSteamUser | Bruger-handle, som grænsefladen hentes fra. |
hSteamPipe | HSteamPipe | Pipen, som grænsefladen skal tilgås gennem. |
pchVersion | const char * | Versionsstrengen, som identificerer versionen af grænsefladen, du modtager. |
Henter
ISteamRemoteStorage-grænsefladen tilknyttet det specifikke bruger-handle.
En konstant, som indeholder den aktuelle version af grænsefladen, er: "STEAMREMOTESTORAGE_INTERFACE_VERSION"
Det bør aldrig være nødvendigt at bruge dette under normale forhold. Det er normalt funktionelt svarende til at kalde den globale accessor:
SteamRemoteStorage()
Returværdier: ISteamRemoteStorage *
En pointer til implementeringen af SteamRemoteStorage tilknyttet den givne HSteamUser.
Returnerer NULL, hvis nogen af argumenterne er ugyldige.
GetISteamScreenshots
ISteamScreenshots * GetISteamScreenshots( HSteamUser hSteamUser, HSteamPipe hSteamPipe, const char *pchVersion );
Navn | Type | Beskrivelse |
hSteamUser | HSteamUser | Bruger-handle, som grænsefladen hentes fra. |
hSteamPipe | HSteamPipe | Pipen, som grænsefladen skal tilgås gennem. |
pchVersion | const char * | Versionsstrengen, som identificerer versionen af grænsefladen, du modtager. |
Henter
ISteamScreenshots-grænsefladen tilknyttet det specifikke bruger-handle.
En konstant, som indeholder den aktuelle version af grænsefladen, er: "STEAMSCREENSHOTS_INTERFACE_VERSION"
Det bør aldrig være nødvendigt at bruge dette under normale forhold. Det er normalt funktionelt svarende til at kalde den globale accessor:
SteamScreenshots()
Returværdier: ISteamScreenshots *
En pointer til implementeringen af SteamScreenshots tilknyttet den givne HSteamUser.
Returnerer NULL, hvis nogen af argumenterne er ugyldige.
GetISteamUGC
ISteamUGC * GetISteamUGC( HSteamUser hSteamUser, HSteamPipe hSteamPipe, const char *pchVersion );
Navn | Type | Beskrivelse |
hSteamUser | HSteamUser | Bruger-handle, som grænsefladen hentes fra. |
hSteamPipe | HSteamPipe | Pipen, som grænsefladen skal tilgås gennem. |
pchVersion | const char * | Versionsstrengen, som identificerer versionen af grænsefladen, du modtager. |
Henter
ISteamUGC-grænsefladen tilknyttet det specifikke bruger-handle.
En konstant, som indeholder den aktuelle version af grænsefladen, er: "STEAMUGC_INTERFACE_VERSION"
Det bør aldrig være nødvendigt at bruge dette under normale forhold. Det er normalt funktionelt svarende til at kalde den globale accessor:
SteamUGC()
Returværdier: ISteamUGC *
En pointer til implementeringen af SteamUGC tilknyttet den givne HSteamUser.
Returnerer NULL, hvis nogen af argumenterne er ugyldige.
GetISteamUnifiedMessages
ISteamUnifiedMessages * GetISteamUnifiedMessages( HSteamUser hSteamUser, HSteamPipe hSteamPipe, const char *pchVersion );
Navn | Type | Beskrivelse |
hSteamUser | HSteamUser | Bruger-handle, som grænsefladen hentes fra. |
hSteamPipe | HSteamPipe | Pipen, som grænsefladen skal tilgås gennem. |
pchVersion | const char * | Versionsstrengen, som identificerer versionen af grænsefladen, du modtager. |
Henter
ISteamUnifiedMessages-grænsefladen tilknyttet det specifikke bruger-handle.
En konstant, som indeholder den aktuelle version af grænsefladen, er: "STEAMUNIFIEDMESSAGES_INTERFACE_VERSION"
Det bør aldrig være nødvendigt at bruge dette under normale forhold. Det er normalt funktionelt svarende til at kalde den globale accessor:
SteamUnifiedMessages()
Returværdier: ISteamUnifiedMessages *
En pointer til implementeringen af SteamUnifiedMessages tilknyttet den givne HSteamUser.
Returnerer NULL, hvis nogen af argumenterne er ugyldige.
GetISteamUser
ISteamUser * GetISteamUser( HSteamUser hSteamUser, HSteamPipe hSteamPipe, const char *pchVersion );
Navn | Type | Beskrivelse |
hSteamUser | HSteamUser | Bruger-handle, som grænsefladen hentes fra. |
hSteamPipe | HSteamPipe | Pipen, som grænsefladen skal tilgås gennem. |
pchVersion | const char * | Versionsstrengen, som identificerer versionen af grænsefladen, du modtager. |
Henter
ISteamUser-grænsefladen tilknyttet det specifikke bruger-handle.
En konstant, som indeholder den aktuelle version af grænsefladen, er: "STEAMUSER_INTERFACE_VERSION"
Det bør aldrig være nødvendigt at bruge dette under normale forhold. Det er normalt funktionelt svarende til at kalde den globale accessor:
SteamUser()
Returværdier: ISteamUser *
En pointer til implementeringen af SteamUser tilknyttet den givne HSteamUser.
Returnerer NULL, hvis nogen af argumenterne er ugyldige.
GetISteamUserStats
ISteamUserStats * GetISteamUserStats( HSteamUser hSteamUser, HSteamPipe hSteamPipe, const char *pchVersion );
Navn | Type | Beskrivelse |
hSteamUser | HSteamUser | Bruger-handle, som grænsefladen hentes fra. |
hSteamPipe | HSteamPipe | Pipen, som grænsefladen skal tilgås gennem. |
pchVersion | const char * | Versionsstrengen, som identificerer versionen af grænsefladen, du modtager. |
Henter
ISteamUserStats-grænsefladen tilknyttet det specifikke bruger-handle.
En konstant, som indeholder den aktuelle version af grænsefladen, er: "STEAMUSERSTATS_INTERFACE_VERSION"
Det bør aldrig være nødvendigt at bruge dette under normale forhold. Det er normalt funktionelt svarende til at kalde den globale accessor:
SteamUserStats()
Returværdier: ISteamUserStats *
En pointer til implementeringen af SteamUserStats tilknyttet den givne HSteamUser.
Returnerer NULL, hvis nogen af argumenterne er ugyldige.
GetISteamUtils
ISteamUtils * GetISteamUtils( HSteamPipe hSteamPipe, const char *pchVersion );
Navn | Type | Beskrivelse |
hSteamPipe | HSteamPipe | Pipen, som grænsefladen skal tilgås gennem. |
pchVersion | const char * | Versionsstrengen, som identificerer versionen af grænsefladen, du modtager. |
Henter
ISteamUtils-grænsefladen tilknyttet det specifikke bruger-handle.
En konstant, som indeholder den aktuelle version af grænsefladen, er: "STEAMUTILS_INTERFACE_VERSION"
Det bør aldrig være nødvendigt at bruge dette under normale forhold. Det er normalt funktionelt svarende til at kalde den globale accessor:
SteamUtils()
Returværdier: ISteamUtils *
En pointer til implementeringen af SteamUtils tilknyttet den givne HSteamUser.
Returnerer NULL, hvis nogen af argumenterne er ugyldige.
GetISteamVideo
ISteamVideo * GetISteamVideo( HSteamUser hSteamUser, HSteamPipe hSteamPipe, const char *pchVersion );
Navn | Type | Beskrivelse |
hSteamUser | HSteamUser | Bruger-handle, som grænsefladen hentes fra. |
hSteamPipe | HSteamPipe | Pipen, som grænsefladen skal tilgås gennem. |
pchVersion | const char * | Versionsstrengen, som identificerer versionen af grænsefladen, du modtager. |
Henter
ISteamVideo-grænsefladen tilknyttet det specifikke bruger-handle.
En konstant, som indeholder den aktuelle version af grænsefladen, er: "STEAMVIDEO_INTERFACE_VERSION"
Det bør aldrig være nødvendigt at bruge dette under normale forhold. Det er normalt funktionelt svarende til at kalde den globale accessor:
SteamVideo()
Returværdier: ISteamVideo *
En pointer til implementeringen af SteamVideo tilknyttet den givne HSteamUser.
Returnerer NULL, hvis nogen af argumenterne er ugyldige.
ReleaseUser
void ReleaseUser( HSteamPipe hSteamPipe, HSteamUser hUser );
Navn | Type | Beskrivelse |
hSteamPipe | HSteamPipe | Forbindelsespipen, hvorfra brugeren skal fjernes. |
hUser | HSteamUser | Brugeren, som skal fjernes. |
Fjerner en allokeret bruger.
IKKE TRÅDSIKKER – sørg for, at ingen andre tråde tilgår Steamworks-API, når funktionen kaldes!
SetLocalIPBinding
void SetLocalIPBinding( uint32 unIP, uint16 usPort );
Navn | Type | Beskrivelse |
unIP | uint32 | Den lokale IP, som der skal knyttes til. |
usPort | uint16 | Porten, som der skal knyttes til. |
Sæt den lokale IP og port, som der skal knyttes til.
Dette skal angives, før
CreateLocalUser kaldes!
SetWarningMessageHook
void SetWarningMessageHook( SteamAPIWarningMessageHook_t pFunction );
Navn | Type | Beskrivelse |
pFunction | SteamAPIWarningMessageHook_t | Funktionspointer til tilbagekaldsfunktionen. |
Indstiller en advarselsbesked-hook, som modtager Steam-API-advarsler og informationsbeskeder i tilbagekaldsfunktionen.
Funktionens prototype skal matche definitionen i SteamAPIWarningMessageHook_t. Dette inkluderer den eksterne "C"-binding og kaldekonventionen __cdecl.
"int nSeverity" er niveauet for alvoren: 0 for besked, 1 for advarsel. Hvis du kører ind gennem et fejlfindingsprogram, er det kun advarsler, som sendes. Hvis du tilføjer -debug_steamapi til kommandolinjen, vil informationsbeskeder også blive sendt.
Beskedens tekst er "const char * pchDebugText".
Tilbagekald vil opstå direkte, efter API-funktionen kaldes, som genererede advarslen eller beskeden.
Overførsel af NULL vil unhooke.
Eksempel:extern "C" void __cdecl SteamAPIDebugTextHook( int nSeverity, const char *pchDebugText )
{
::OutputDebugString( pchDebugText );
if ( nSeverity >= 1 )
{
// sted til indsætning af pausepunkt til at fange API-fejl
int x = 3;
x = x;
}
}
void EnableWarningMessageHook()
{
SteamUtils()->SetWarningMessageHook( &SteamAPIDebugTextHook );
}
Typedefs
Disse er typedefinitioner, som defineres til brug med ISteamClient.
Navn | Basistype | Beskrivelse |
HSteamPipe | int32 | Handle til en kommunikationspipe til Steam-klienten. |
HSteamUser | int32 | Handle til en enkelt forekomst af en Steam-bruger. |