새로운 Steam 인스턴스를 생성하거나, 다른 프로세스 또는 로컬에 있는 기존 Steam 인스턴스를 연결하기 위한 인터페이스입니다.
대부분의 경우,
SteamAPI_Init를 통해 자동으로 처리됩니다.
버전 관리 체계가 더 복잡할 때나 단일 프로세스가 독립적인 게임 서버의 Steam ID로 여러 게임을 처리하는 다중 게임 서버를 구현하고자 할 때만 해당 API가 필요합니다.
멤버 함수
ISteamClient의 멤버 함수는 전역 접근자 함수
SteamClient()를 통해 호출됩니다.
BReleaseSteamPipe
bool BReleaseSteamPipe( HSteamPipe hSteamPipe );
이전에 만든 커뮤니케이션 파이프를 출시합니다.
NOT THREADSAFE - 호출 시 다른 스레드가 Steamworks API에 접근하면 안 됩니다!
반환값: bool
? 파이프가 유효하고 성공적으로 출시되었으면
true를, 그렇지 않으면 false를 반환합니다.
BShutdownIfAllPipesClosed
bool BShutdownIfAllPipesClosed();
모든 파이프가 종료되면, DLL에 대한 전체 종료를 실행합니다.
반환값: bool
ConnectToGlobalUser
HSteamUser ConnectToGlobalUser( HSteamPipe hSteamPipe );
기존의 전역 사용자에게 연결되며, 아무도 없는 경우 연결에 실패합니다.
SteamUI와 조정하기 위해 게임에서 사용되었습니다.
NOT THREADSAFE - 호출 시 다른 스레드가 Steamworks API에 접근하면 안 됩니다!
반환값: HSteamUser전역 사용자의 HSteamUser 핸들입니다. 파이프가 유효하지 않거나 전체 사용자가 없는 경우, 0을 반환합니다.
CreateLocalUser
HSteamUser CreateLocalUser( HSteamPipe *phSteamPipe, EAccountType eAccountType );
다른 사람과 공유되지 않을 Steam 사용자를 생성합니다. 게임 서버에서만 사용됩니다.
NOT THREADSAFE - 호출 시 다른 스레드가 Steamworks API에 접근하면 안 됩니다!
반환값: HSteamUserSteamUser의 새로운 핸들입니다.
CreateSteamPipe
HSteamPipe CreateSteamPipe();
Steam 클라이언트에 대한 커뮤니케이션 파이프를 생성합니다.
NOT THREADSAFE - 호출 시 다른 스레드가 Steamworks API에 접근하면 안 됩니다
반환값: HSteamPipeGetIPCCallCount
uint32 GetIPCCallCount();
해당 함수가 마지막으로 호출된 이후에 호출된 IPC(Inter-Process Communication) 호출 수를 반환합니다.
성능 디버깅에 사용하여 게임의 프레임당 IPC 호출 수를 파악할 수 있습니다. 각 IPC 호출은 프로세스 스위치이거나 적어도 스레드 컨텍스트 스위치이므로, 호출을 사용하는 빈도를 주의 깊게 조절해야 합니다.
반환값: uint32GetISteamApps
ISteamApps * GetISteamApps( HSteamUser hSteamUser, HSteamPipe hSteamPipe, const char *pchVersion );
| 이름 | 유형 | 설명 |
|---|
| hSteamUser | HSteamUser | 인터페이스를 불러오려는 사용자 핸들 |
| hSteamPipe | HSteamPipe | 인터페이스에 접근하려는 파이프 |
| pchVersion | const char * | 받으려는 인터페이스에 대한 버전을 식별하는 버전 문자열 |
지정된 사용자 핸들과 연결된
ISteamApps 인터페이스를 가져옵니다.
현재 버전의 인터페이스를 포함하는 상수는 'STEAMAPPS_INTERFACE_VERSION'입니다.
일반적인 상태에서는 해당 함수를 사용할 필요가 없습니다. 기능상으로는
SteamApps() 전역 접근자를 호출하는 것과 동일합니다.
반환값: ISteamApps *
주어진 HSteamUser와 연동된 SteamApps를 구현하기 위한 포인터입니다.
인수 중 하나라도 유효하지 않은 경우 NULL을 반환합니다.
GetISteamController
ISteamController * GetISteamController( HSteamUser hSteamUser, HSteamPipe hSteamPipe, const char *pchVersion );
| 이름 | 유형 | 설명 |
|---|
| hSteamUser | HSteamUser | 인터페이스를 불러오려는 사용자 핸들 |
| hSteamPipe | HSteamPipe | 인터페이스에 접근하려는 파이프 |
| pchVersion | const char * | 받으려는 인터페이스에 대한 버전을 식별하는 버전 문자열 |
지정된 사용자 핸들과 연결된
ISteamController 인터페이스를 가져옵니다.
현재 버전의 인터페이스를 포함하는 상수는 'STEAMCONTROLLER_INTERFACE_VERSION'입니다.
일반적인 상태에서는 해당 함수를 사용할 필요가 없습니다. 기능상으로는
SteamController() 전역 접근자를 호출하는 것과 동일합니다
반환값: ISteamController *
주어진 HSteamUser와 연동된 SteamController를 구현하기 위한 포인터입니다.
인수 중 하나라도 유효하지 않은 경우 NULL을 반환합니다.
GetISteamFriends
ISteamFriends * GetISteamFriends( HSteamUser hSteamUser, HSteamPipe hSteamPipe, const char *pchVersion );
| 이름 | 유형 | 설명 |
|---|
| hSteamUser | HSteamUser | 인터페이스를 불러오려는 사용자 핸들 |
| hSteamPipe | HSteamPipe | 인터페이스에 접근하려는 파이프 |
| pchVersion | const char * | 받으려는 인터페이스의 버전을 식별하는 버전 문자열 |
지정된 사용자 핸들과 연결된
ISteamFriends 인터페이스를 가져옵니다.
현재 버전의 인터페이스를 포함하는 상수는 'STEAMFRIENDS_INTERFACE_VERSION'입니다.
일반적인 상태에서는 해당 함수를 사용할 필요가 없습니다. 기능상으로는
SteamFriends() 전역 접근자를 호출하는 것과 동일합니다.
반환값: ISteamFriends *
주어진 HSteamUser와 연동된 SteamFriends를 구현하기 위한 포인터입니다.
인수 중 하나라도 유효하지 않은 경우 NULL을 반환합니다.
GetISteamGameServer
ISteamGameServer * GetISteamGameServer( HSteamUser hSteamUser, HSteamPipe hSteamPipe, const char *pchVersion );
| 이름 | 유형 | 설명 |
|---|
| hSteamUser | HSteamUser | 인터페이스를 불러오려는 사용자 핸들 |
| hSteamPipe | HSteamPipe | 인터페이스에 접근하려는 파이프 |
| pchVersion | const char * | 받으려는 인터페이스의 버전을 식별하는 버전 문자열 |
지정된 사용자 핸들과 연결된
ISteamGameServer 인터페이스를 가져옵니다.
현재 버전의 인터페이스를 포함하는 상수는 'STEAMGAMESERVER_INTERFACE_VERSION'입니다.
일반적인 상태에서는 해당 함수를 사용할 필요가 없습니다. 기능상으로는
SteamGameServer() 전역 접근자를 호출하는 것과 동일합니다.
반환값: ISteamGameServer *
주어진 HSteamUser와 연동된 SteamGameServer를 구현하기 위한 포인터입니다.
인수 중 하나라도 유효하지 않은 경우 NULL을 반환합니다.
GetISteamGameServerStats
ISteamGameServerStats * GetISteamGameServerStats( HSteamUser hSteamUser, HSteamPipe hSteamPipe, const char *pchVersion );
| 이름 | 유형 | 설명 |
|---|
| hSteamUser | HSteamUser | 인터페이스를 불러오려는 사용자 핸들 |
| hSteamPipe | HSteamPipe | 인터페이스에 접근하려는 파이프 |
| pchVersion | const char * | 받으려는 인터페이스의 버전을 식별하는 버전 문자열 |
지정된 사용자 핸들과 연결된
ISteamGameServerStats 인터페이스를 가져옵니다.
현재 버전의 인터페이스를 포함하는 상수는 'STEAMGAMESERVERSTATS_INTERFACE_VERSION'입니다.
일반적인 상태에서는 해당 함수를 사용할 필요가 없습니다. 기능상으로는
SteamGameServerStats() 전역 접근자를 호출하는 것과 동일합니다.
반환값: ISteamGameServerStats *
주어진 HSteamUser와 연동된 SteamGameServerStats를 구현하기 위한 포인터입니다.
인수 중 하나라도 유효하지 않은 경우 NULL을 반환합니다.
GetISteamGenericInterface
void * GetISteamGenericInterface( HSteamUser hSteamUser, HSteamPipe hSteamPipe, const char *pchVersion );
| 이름 | 유형 | 설명 |
|---|
| hSteamUser | HSteamUser | 인터페이스를 불러오려는 사용자 핸들 |
| hSteamPipe | HSteamPipe | 인터페이스에 접근하려는 파이프 |
| pchVersion | const char * | 받으려는 인터페이스의 버전을 식별하는 버전 문자열 |
사용자 핸들과 연결된 일반 인터페이스를 불러옵니다.
일반적인 상태에서는 해당 함수를 사용할 필요가 없습니다.
반환값: void *
주어진 HSteamUser와 연동된 인터페이스를 구현하기 위한 포인터입니다.
인수 중 하나라도 유효하지 않은 경우 NULL을 반환합니다.
GetISteamHTMLSurface
ISteamHTMLSurface * GetISteamHTMLSurface( HSteamUser hSteamUser, HSteamPipe hSteamPipe, const char *pchVersion );
| 이름 | 유형 | 설명 |
|---|
| hSteamUser | HSteamUser | 인터페이스를 불러오려는 사용자 핸들 |
| hSteamPipe | HSteamPipe | 인터페이스에 접근하려는 파이프 |
| pchVersion | const char * | 받으려는 인터페이스의 버전을 식별하는 버전 문자열 |
지정된 사용자 핸들과 연결된
ISteamHTMLSurface 인터페이스를 가져옵니다.
현재 버전의 인터페이스를 포함하는 상수는 'STEAMHTMLSURFACE_INTERFACE_VERSION'입니다.
일반적인 상태에서는 해당 함수를 사용할 필요가 없습니다. 기능상으로는
SteamHTMLSurface() 전역 접근자를 호출하는 것과 동일합니다.
반환값: ISteamHTMLSurface *
주어진 HSteamUser와 연동된 SteamHTMLSurface를 구현하기 위한 포인터입니다.
인수 중 하나라도 유효하지 않은 경우 NULL을 반환합니다.
GetISteamHTTP
ISteamHTTP * GetISteamHTTP( HSteamUser hSteamUser, HSteamPipe hSteamPipe, const char *pchVersion );
| 이름 | 유형 | 설명 |
|---|
| hSteamUser | HSteamUser | 인터페이스를 불러오려는 사용자 핸들 |
| hSteamPipe | HSteamPipe | 인터페이스에 접근하려는 파이프 |
| pchVersion | const char * | 받으려는 인터페이스의 버전을 식별하는 버전 문자열 |
지정된 사용자 핸들과 연결된
ISteamHTTP 인터페이스를 가져옵니다.
현재 버전의 인터페이스를 포함하는 상수는 'STEAMHTTP_INTERFACE_VERSION'입니다.
일반적인 상태에서는 해당 함수를 사용할 필요가 없습니다. 기능상으로는
SteamHTTP() 전역 접근자를 호출하는 것과 동일합니다.
반환값: ISteamHTTP *
주어진 HSteamUser와 연동된 SteamHTTP를 구현하기 위한 포인터입니다.
인수 중 하나라도 유효하지 않은 경우 NULL을 반환합니다.
GetISteamInventory
ISteamInventory * GetISteamInventory( HSteamUser hSteamUser, HSteamPipe hSteamPipe, const char *pchVersion );
| 이름 | 유형 | 설명 |
|---|
| hSteamUser | HSteamUser | 인터페이스를 불러오려는 사용자 핸들 |
| hSteamPipe | HSteamPipe | 인터페이스에 접근하려는 파이프 |
| pchVersion | const char * | 받으려는 인터페이스의 버전을 식별하는 버전 문자열 |
지정된 사용자 핸들과 연결된
ISteamInventory 인터페이스를 가져옵니다.
현재 버전의 인터페이스를 포함하는 상수는 'STEAMINVENTORY_INTERFACE_VERSION'입니다.
일반적인 상태에서는 해당 함수를 사용할 필요가 없습니다. 기능상으로는
SteamInventory() 전역 접근자를 호출하는 것과 동일합니다.
반환값: ISteamInventory *
주어진 HSteamUser와 연동된 SteamInventory를 구현하기 위한 포인터입니다.
인수 중 하나라도 유효하지 않은 경우 NULL을 반환합니다.
GetISteamMatchmaking
ISteamMatchmaking * GetISteamMatchmaking( HSteamUser hSteamUser, HSteamPipe hSteamPipe, const char *pchVersion );
| 이름 | 유형 | 설명 |
|---|
| hSteamUser | HSteamUser | 인터페이스를 불러오려는 사용자 핸들 |
| hSteamPipe | HSteamPipe | 인터페이스에 접근하려는 파이프 |
| pchVersion | const char * | 받으려는 인터페이스의 버전을 식별하는 버전 문자열 |
지정된 사용자 핸들과 연결된
ISteamMatchmaking 인터페이스를 가져옵니다.
현재 버전의 인터페이스를 포함하는 상수는 'STEAMMATCHMAKING_INTERFACE_VERSION'입니다.
일반적인 상태에서는 해당 함수를 사용할 필요가 없습니다. 기능상으로는
SteamMatchmaking() 전역 접근자를 호출하는 것과 동일합니다.
반환값: ISteamMatchmaking *
주어진 HSteamUser와 연동된 SteamMatchmaking을 구현하기 위한 포인터입니다.
인수 중 하나라도 유효하지 않은 경우 NULL을 반환합니다.
GetISteamMatchmakingServers
ISteamMatchmakingServers * GetISteamMatchmakingServers( HSteamUser hSteamUser, HSteamPipe hSteamPipe, const char *pchVersion );
| 이름 | 유형 | 설명 |
|---|
| hSteamUser | HSteamUser | 인터페이스를 불러오려는 사용자 핸들 |
| hSteamPipe | HSteamPipe | 인터페이스에 접근하려는 파이프 |
| pchVersion | const char * | 받으려는 인터페이스의 버전을 식별하는 버전 문자열 |
지정된 사용자 핸들과 연결된
ISteamMatchmakingServers 인터페이스를 가져옵니다.
현재 버전의 인터페이스를 포함하는 상수는 'STEAMMATCHMAKINGSERVERS_INTERFACE_VERSION'입니다.
일반적인 상태에서는 해당 함수를 사용할 필요가 없습니다. 기능상으로는
SteamMatchmakingServers() 전역 접근자를 호출하는 것과 동일합니다.
반환값: ISteamMatchmakingServers *
주어진 HSteamUser와 연동된 SteamMatchmakingServers를 구현하기 위한 포인터입니다.
인수 중 하나라도 유효하지 않은 경우 NULL을 반환합니다.
GetISteamMusic
ISteamMusic * GetISteamMusic( HSteamUser hSteamUser, HSteamPipe hSteamPipe, const char *pchVersion );
| 이름 | 유형 | 설명 |
|---|
| hSteamUser | HSteamUser | 인터페이스를 불러오려는 사용자 핸들 |
| hSteamPipe | HSteamPipe | 인터페이스에 접근하려는 파이프 |
| pchVersion | const char * | 받으려는 인터페이스의 버전을 식별하는 버전 문자열 |
지정된 사용자 핸들과 연결된
ISteamMusic 인터페이스를 가져옵니다.
현재 버전의 인터페이스를 포함하는 상수는 'STEAMMUSIC_INTERFACE_VERSION'입니다.
일반적인 상태에서는 해당 함수를 사용할 필요가 없습니다. 기능상으로는
SteamMusic() 전역 접근자를 호출하는 것과 동일합니다.
반환값: ISteamMusic *
주어진 HSteamUser와 연동된 SteamMusic을 구현하기 위한 포인터입니다.
인수 중 하나라도 유효하지 않은 경우 NULL을 반환합니다.
GetISteamMusicRemote
ISteamMusicRemote * GetISteamMusicRemote( HSteamUser hSteamUser, HSteamPipe hSteamPipe, const char *pchVersion );
| 이름 | 유형 | 설명 |
|---|
| hSteamUser | HSteamUser | 인터페이스를 불러오려는 사용자 핸들 |
| hSteamPipe | HSteamPipe | 인터페이스에 접근하려는 파이프 |
| pchVersion | const char * | 받으려는 인터페이스의 버전을 식별하는 버전 문자열 |
지정된 사용자 핸들과 연결된
ISteamMusicRemote 인터페이스를 가져옵니다.
현재 버전의 인터페이스를 포함하는 상수는 'STEAMMUSICREMOTE_INTERFACE_VERSION'입니다.
일반적인 상태에서는 해당 함수를 사용할 필요가 없습니다. 기능상으로는
SteamMusicRemote() 전역 접근자를 호출하는 것과 동일합니다.
반환값: ISteamMusicRemote *
주어진 HSteamUser와 연동된 SteamMusicRemote를 구현하기 위한 포인터입니다.
인수 중 하나라도 유효하지 않은 경우 NULL을 반환합니다.
GetISteamNetworking
ISteamNetworking * GetISteamNetworking( HSteamUser hSteamUser, HSteamPipe hSteamPipe, const char *pchVersion );
| 이름 | 유형 | 설명 |
|---|
| hSteamUser | HSteamUser | 인터페이스를 불러오려는 사용자 핸들 |
| hSteamPipe | HSteamPipe | 인터페이스에 접근하려는 파이프 |
| pchVersion | const char * | 받으려는 인터페이스의 버전을 식별하는 버전 문자열 |
지정된 사용자 핸들과 연결된
ISteamNetworking 인터페이스를 가져옵니다.
현재 버전의 인터페이스를 포함하는 상수는 'STEAMNETWORKING_INTERFACE_VERSION'입니다.
일반적인 상태에서는 해당 함수를 사용할 필요가 없습니다. 기능상으로는
SteamNetworking() 전역 접근자를 호출하는 것과 동일합니다.
반환값: ISteamNetworking *
주어진 HSteamUser와 연동된 SteamNetworking을 구현하기 위한 포인터입니다.
인수 중 하나라도 유효하지 않은 경우 NULL을 반환합니다.
GetISteamRemoteStorage
ISteamRemoteStorage * GetISteamRemoteStorage( HSteamUser hSteamUser, HSteamPipe hSteamPipe, const char *pchVersion );
| 이름 | 유형 | 설명 |
|---|
| hSteamUser | HSteamUser | 인터페이스를 불러오려는 사용자 핸들 |
| hSteamPipe | HSteamPipe | 인터페이스에 접근하려는 파이프 |
| pchVersion | const char * | 받으려는 인터페이스의 버전을 식별하는 버전 문자열 |
지정된 사용자 핸들과 연결된
ISteamRemoteStorage 인터페이스를 가져옵니다.
현재 버전의 인터페이스를 포함하는 상수는 'STEAMREMOTESTORAGE_INTERFACE_VERSION'입니다.
일반적인 상태에서는 해당 함수를 사용할 필요가 없습니다. 기능상으로는
SteamRemoteStorage() 전역 접근자를 호출하는 것과 동일합니다.
반환값: ISteamRemoteStorage *
주어진 HSteamUser와 연동된 SteamRemoteStorage를 구현하기 위한 포인터입니다.
인수 중 하나라도 유효하지 않은 경우 NULL을 반환합니다.
GetISteamScreenshots
ISteamScreenshots * GetISteamScreenshots( HSteamUser hSteamUser, HSteamPipe hSteamPipe, const char *pchVersion );
| 이름 | 유형 | 설명 |
|---|
| hSteamUser | HSteamUser | 인터페이스를 불러오려는 사용자 핸들 |
| hSteamPipe | HSteamPipe | 인터페이스에 접근하려는 파이프 |
| pchVersion | const char * | 받으려는 인터페이스의 버전을 식별하는 버전 문자열 |
지정된 사용자 핸들과 연결된
ISteamScreenshots 인터페이스를 가져옵니다.
현재 버전의 인터페이스를 포함하는 상수는 'STEAMSCREENSHOTS_INTERFACE_VERSION'입니다.
일반적인 상태에서는 해당 함수를 사용할 필요가 없습니다. 기능상으로는
SteamScreenshots() 전역 접근자를 호출하는 것과 동일합니다.
반환값: ISteamScreenshots *
주어진 HSteamUser와 연동된 SteamScreenshots을 구현하기 위한 포인터입니다.
인수 중 하나라도 유효하지 않은 경우 NULL을 반환합니다.
GetISteamUGC
ISteamUGC * GetISteamUGC( HSteamUser hSteamUser, HSteamPipe hSteamPipe, const char *pchVersion );
| 이름 | 유형 | 설명 |
|---|
| hSteamUser | HSteamUser | 인터페이스를 불러오려는 사용자 핸들 |
| hSteamPipe | HSteamPipe | 인터페이스에 접근하려는 파이프 |
| pchVersion | const char * | 받으려는 인터페이스의 버전을 식별하는 버전 문자열 |
지정된 사용자 핸들과 연결된
ISteamUGC 인터페이스를 가져옵니다.
현재 버전의 인터페이스를 포함하는 상수는 'STEAMUGC_INTERFACE_VERSION'입니다.
일반적인 상태에서는 해당 함수를 사용할 필요가 없습니다. 기능상으로는
SteamUGC() 전역 접근자를 호출하는 것과 동일합니다.
반환값: ISteamUGC *
주어진 HSteamUser와 연동된 SteamUGC를 구현하기 위한 포인터입니다.
인수 중 하나라도 유효하지 않은 경우 NULL을 반환합니다.
GetISteamUnifiedMessages
ISteamUnifiedMessages * GetISteamUnifiedMessages( HSteamUser hSteamUser, HSteamPipe hSteamPipe, const char *pchVersion );
| 이름 | 유형 | 설명 |
|---|
| hSteamUser | HSteamUser | 인터페이스를 불러오려는 사용자 핸들 |
| hSteamPipe | HSteamPipe | 인터페이스에 접근하려는 파이프 |
| pchVersion | const char * | 받으려는 인터페이스의 버전을 식별하는 버전 문자열 |
지정된 사용자 핸들과 연결된
ISteamUnifiedMessages 인터페이스를 가져옵니다.
현재 버전의 인터페이스를 포함하는 상수는 'STEAMUNIFIEDMESSAGES_INTERFACE_VERSION'입니다.
일반적인 상태에서는 해당 함수를 사용할 필요가 없습니다. 기능상으로는
SteamUnifiedMessages() 전역 접근자를 호출하는 것과 동일합니다.
반환값: ISteamUnifiedMessages *
주어진 HSteamUser와 연동된 SteamUnifiedMessages를 구현하기 위한 포인터입니다.
인수 중 하나라도 유효하지 않은 경우 NULL을 반환합니다.
GetISteamUser
ISteamUser * GetISteamUser( HSteamUser hSteamUser, HSteamPipe hSteamPipe, const char *pchVersion );
| 이름 | 유형 | 설명 |
|---|
| hSteamUser | HSteamUser | 인터페이스를 불러오려는 사용자 핸들 |
| hSteamPipe | HSteamPipe | 인터페이스에 접근하려는 파이프 |
| pchVersion | const char * | 받으려는 인터페이스의 버전을 식별하는 버전 문자열 |
지정된 사용자 핸들과 연결된
ISteamUser 인터페이스를 가져옵니다.
현재 버전의 인터페이스를 포함하는 상수는 'STEAMUSER_INTERFACE_VERSION'입니다.
일반적인 상태에서는 해당 함수를 사용할 필요가 없습니다. 기능상으로는
SteamUser() 전역 접근자를 호출하는 것과 동일합니다.
반환값: ISteamUser *
주어진 HSteamUser와 연동된 SteamUser를 구현하기 위한 포인터입니다.
인수 중 하나라도 유효하지 않은 경우 NULL을 반환합니다.
GetISteamUserStats
ISteamUserStats * GetISteamUserStats( HSteamUser hSteamUser, HSteamPipe hSteamPipe, const char *pchVersion );
| 이름 | 유형 | 설명 |
|---|
| hSteamUser | HSteamUser | 인터페이스를 불러오려는 사용자 핸들 |
| hSteamPipe | HSteamPipe | 인터페이스에 접근하려는 파이프 |
| pchVersion | const char * | 받으려는 인터페이스의 버전을 식별하는 버전 문자열 |
지정된 사용자 핸들과 연결된
ISteamUserStats 인터페이스를 가져옵니다.
현재 버전의 인터페이스를 포함하는 상수는 'STEAMUSERSTATS_INTERFACE_VERSION'입니다.
일반적인 상태에서는 해당 함수를 사용할 필요가 없습니다. 기능상으로는
SteamUserStats() 전역 접근자를 호출하는 것과 동일합니다.
반환값: ISteamUserStats *
주어진 HSteamUser와 연동된 SteamUserStats를 구현하기 위한 포인터입니다.
인수 중 하나라도 유효하지 않은 경우 NULL을 반환합니다.
GetISteamUtils
ISteamUtils * GetISteamUtils( HSteamPipe hSteamPipe, const char *pchVersion );
| 이름 | 유형 | 설명 |
|---|
| hSteamPipe | HSteamPipe | 인터페이스에 접근하려는 파이프 |
| pchVersion | const char * | 받으려는 인터페이스의 버전을 식별하는 버전 문자열 |
지정된 사용자 핸들과 연결된
ISteamUtils 인터페이스를 가져옵니다.
현재 버전의 인터페이스를 포함하는 상수는 'STEAMUTILS_INTERFACE_VERSION'입니다.
일반적인 상태에서는 해당 함수를 사용할 필요가 없습니다. 기능상으로는
SteamUtils() 전역 접근자를 호출하는 것과 동일합니다.
반환값: ISteamUtils *
주어진 HSteamUser와 연동된 SteamUtils를 구현하기 위한 포인터입니다.
인수 중 하나라도 유효하지 않은 경우 NULL을 반환합니다.
GetISteamVideo
ISteamVideo * GetISteamVideo( HSteamUser hSteamUser, HSteamPipe hSteamPipe, const char *pchVersion );
| 이름 | 유형 | 설명 |
|---|
| hSteamUser | HSteamUser | 인터페이스를 불러오려는 사용자 핸들 |
| hSteamPipe | HSteamPipe | 인터페이스에 접근하려는 파이프 |
| pchVersion | const char * | 받으려는 인터페이스의 버전을 식별하는 버전 문자열 |
지정된 사용자 핸들과 연결된
ISteamVideo 인터페이스를 가져옵니다.
현재 버전의 인터페이스를 포함하는 상수는 'STEAMVIDEO_INTERFACE_VERSION'입니다.
일반적인 상태에서는 해당 함수를 사용할 필요가 없습니다. 기능상으로는
SteamVideo() 전역 접근자를 호출하는 것과 동일합니다.
반환값: ISteamVideo *
주어진 HSteamUser와 연동된 SteamVideo를 구현하기 위한 포인터입니다.
인수 중 하나라도 유효하지 않은 경우 NULL을 반환합니다.
ReleaseUser
void ReleaseUser( HSteamPipe hSteamPipe, HSteamUser hUser );
할당된 사용자를 제거합니다.
NOT THREADSAFE - 호출 시 다른 스레드가 Steamworks API에 접근하면 안 됩니다!
SetLocalIPBinding
void SetLocalIPBinding( uint32 unIP, uint16 usPort );
바인딩하려는 로컬 IP와 포트를 설정합니다.
반드시
CreateLocalUser를 호출하기 전에 설정하세요!
SetWarningMessageHook
void SetWarningMessageHook( SteamAPIWarningMessageHook_t pFunction );
| 이름 | 유형 | 설명 |
|---|
| pFunction | SteamAPIWarningMessageHook_t | 콜백 함수에 대한 함수 포인터 |
콜백 함수에서 SteamAPI 경고 및 정보 메시지를 받을 수 있도록 경고 메시지 후크를 설정합니다.
함수 프로토타입은 반드시 SteamAPIWarningMessageHook_t의 정의와 일치해야 합니다. 이는 extern "C" 연결과 __cdecl 호출 규약을 포함하고 있습니다.
'int nSeverity'는 심각성을 의미하며 0은 메시지, 1은 경고를 뜻합니다. 디버거를 통해 실행하면 경고만 전송됩니다. 명령 줄에 -debug_steamapi를 추가하는 경우, 정보 메시지도 함께 전송됩니다.
'const char * pchDebugText'가 메시지 문자입니다.
콜백은 경고 또는 메시지를 생성한 API 함수가 호출된 후 바로 발생합니다.
NULL을 전달하면 후크가 해제됩니다.
예시:extern "C" void __cdecl SteamAPIDebugTextHook( int nSeverity, const char *pchDebugText )
{
::OutputDebugString( pchDebugText );
if ( nSeverity >= 1 )
{
// place to set a breakpoint for catching API errors
int x = 3;
x = x;
}
}
void EnableWarningMessageHook()
{
SteamUtils()->SetWarningMessageHook( &SteamAPIDebugTextHook );
}
Typedefs
ISteamClient와 함께 사용하기 위해 정의된 typedefs입니다.
| 이름 | 기본 유형 | 설명 |
|---|
| HSteamPipe | int32 | Steam 클라이언트에 연결할 커뮤니케이션 파이프를 위한 핸들 |
| HSteamUser | int32 | Steam 사용자의 단일 인스턴스를 위한 핸들 |
