Hàm để gửi và nhận thông điệp từ Hệ thống điều phối trò chơi (Game Coordinator).

Phần lớn không còn được sử dụng, và chỉ tiếp tục tồn tại cho một vài trò chơi còn dùng.

Các hàm

LƯU Ý: ISteamGameCoordinator không hiện qua hàm accessor dạng global. Bạn phải truy cập nó qua ISteamClient::GetISteamGenericInterface.

IsMessageAvailable

Tên	Loại	Mô tả
pcubMsgSize	uint32 *	Trả về kích thước thông điệp dưới dạng byte.

Kiểm tra xem nếu có thông điệp nào đang chờ từ hệ thống điều phối trò chơi.

Trả về: bool
true nếu có thông điệp; còn không, false.

RetrieveMessage

Tên	Loại	Mô tả
punMsgType	uint32 *
pubDest	void *
cubDest	uint32
pcubMsgSize	uint32 *

Điền vùng đệm được cung cấp với thông điệp đầu tiên trong hàng chờ và trả về k_EGCResultOK hoặc trả về k_EGCResultNoMessage nếu không có thông điệp nào đang chờ. pcubMsgSize được điền với kích thước thông điệp.

Nếu vùng đệm được cung cấp không đủ lớn cho toàn bộ thông điệp, k_EGCResultBufferTooSmall được trả về và thông điệp sẽ ở lại đầu hàng chờ.

Trả về: EGCResults

SendMessage

Tên	Loại	Mô tả
unMsgType	uint32
pubData	const void *
cubData	uint32

Gửi một thông điệp tới hệ thống điều phối trò chơi.

Trả về: EGCResults

Callback

Đây là các callback có thể kích hoạt bằng cách gọi SteamAPI_RunCallbacks. Rất nhiều trong số này sẽ được kích hoạt trực tiếp để phản hồi lại hàm con của ISteamGameCoordinator.

GCMessageAvailable_t

callbacks
thông báo callback - Có một thông điệp mới để đọc từ hàng chờ thông điệp

Tên	Loại	Mô tả
m_nMessageSize	uint32

GCMessageFailed_t

thông báo callback - Một thông điệp không đến được hệ thống điều phối trò chơi. Có thể nó đang tạm thời không hoạt động

Callback này không có trường.

Enum

Đây là các enum được định nghĩa để dùng với ISteamGameCoordinator.

EGCResults

Danh sách các giá trị trả về khả thi từ API ISteamGameCoordinator.

Tên	Giá trị	Mô tả
k_EGCResultOK	0	Thành công.
k_EGCResultNoMessage	1	Không có thông điệp nào trong hàng chờ.
k_EGCResultBufferTooSmall	2	Vùng đệm quá nhỏ cho thông điệp được yêu cầu.
k_EGCResultNotLoggedOn	3	Client hiện không đăng nhập vào Steam.
k_EGCResultInvalidMessage	4	Có gì đó sai với thông điệp đang được gửi với SendMessage.

Hằng số

Đây là các hằng số được định nghĩa để dùng với ISteamGameCoordinator.

Tên	Loại	Giá trị	Mô tả
STEAMGAMECOORDINATOR_INTERFACE_VERSION	const char *	"SteamGameCoordinator001"