|
Size: 2539
Comment: Changed code sample to use C instead of C++.
|
Size: 2552
Comment: Changed example to be compatible with older C compilers.
|
| Deletions are marked like this. | Additions are marked like this. |
| Line 27: | Line 27: |
| int main(int argc, char *argv[]) { SDL_Window* window; SDL_SysWMinfo info; |
|
| Line 28: | Line 31: |
| int main(int argc, char *argv[]) { | |
| Line 30: | Line 32: |
| SDL_Window* window = SDL_CreateWindow("",0,0,0,0,SDL_WINDOW_HIDDEN); SDL_SysWMinfo info; |
window = SDL_CreateWindow("", 0, 0, 0, 0, SDL_WINDOW_HIDDEN); |
| Line 35: | Line 36: |
| Line 53: | Line 54: |
| Line 58: | Line 58: |
| Line 61: | Line 61: |
return 0; |
SDL_GetWindowWMInfo
Use this function to get driver specific information about a window.
Syntax
SDL_bool SDL_GetWindowWMInfo(SDL_Window* window,
SDL_SysWMinfo* info)
Function Parameters
window |
the window about which information is being requested |
info |
an SDL_SysWMinfo structure filled in with window information; see Remarks for details |
Return Value
Returns SDL_TRUE if the function is implemented and the version member of the info struct is valid, or SDL_FALSE if the information could not be retrieved; call SDL_GetError() for more information.
Code Examples
#include "SDL.h"
#include "SDL_syswm.h"
int main(int argc, char *argv[]) {
SDL_Window* window;
SDL_SysWMinfo info;
SDL_Init(0);
window = SDL_CreateWindow("", 0, 0, 0, 0, SDL_WINDOW_HIDDEN);
SDL_VERSION(&info.version); // initialize info structure with SDL version info
if(SDL_GetWindowWMInfo(window,&info)) { // the call returns true on success
// success
const char *subsystem = "an unknown system!";
switch(info.subsystem) {
case SDL_SYSWM_UNKNOWN: break;
case SDL_SYSWM_WINDOWS: subsystem = "Microsoft Windows(TM)"; break;
case SDL_SYSWM_X11: subsystem = "X Window System"; break;
case SDL_SYSWM_DIRECTFB: subsystem = "DirectFB"; break;
case SDL_SYSWM_COCOA: subsystem = "Apple OS X"; break;
case SDL_SYSWM_UIKIT: subsystem = "UIKit"; break;
}
SDL_Log("This program is running SDL version %d.%d.%d on %s\n",
(int)info.version.major,
(int)info.version.minor,
(int)info.version.patch,
subsystem);
} else {
// call failed
SDL_LogError(SDL_LOG_CATEGORY_ERROR, "Couldn't get window information: %s\n", SDL_GetError());
}
SDL_DestroyWindow(window);
SDL_Quit();
return 0;
}
Remarks
You must include SDL_syswm.h for the declaration of SDL_SysWMinfo.
The info structure must be initialized with the SDL version, and is then filled in with information about the given window, as shown in the Code Example.
CategoryAPI, CategoryVideo, CategorySWM
