SDL_CreateSemaphore.3
上传用户:sun1608
上传日期:2007-02-02
资源大小:6116k
文件大小:1k
源码类别:

流媒体/Mpeg4/MP4

开发平台:

Visual C++

  1. .TH "SDL_CreateSemaphore" "3" "Tue 11 Sep 2001, 23:00" "SDL" "SDL API Reference" 
  2. .SH "NAME"
  3. SDL_CreateSemaphore- Creates a new semaphore and assigns an initial value to it&.
  4. .SH "SYNOPSIS"
  5. .PP
  6. fB#include "SDL&.h"
  7. #include "SDL_thread&.h"
  8. .sp
  9. fBSDL_sem *fBSDL_CreateSemaphorefPfR(fBUint32 initial_valuefR);
  10. .SH "DESCRIPTION"
  11. .PP
  12. fBSDL_CreateSemaphore()fP creates a new semaphore and initializes it with the value fBinitial_valuefR&. Each locking operation on the semaphore by fISDL_SemWaitfR, fISDL_SemTryWaitfR or fISDL_SemWaitTimeoutfR will atomically decrement the semaphore value&. The locking operation will be blocked if the semaphore value is not positive (greater than zero)&. Each unlock operation by fISDL_SemPostfR will atomically increment the semaphore value&.
  13. .SH "RETURN VALUE"
  14. .PP
  15. Returns a pointer to an initialized semaphore or fBNULLfR if there was an error&.
  16. .SH "EXAMPLES"
  17. .PP
  18. .PP
  19. .nf
  20. f(CWSDL_sem *my_sem;
  21. my_sem = SDL_CreateSemaphore(INITIAL_SEM_VALUE);
  22. if (my_sem == NULL) {
  23.         return CREATE_SEM_FAILED;
  24. }fR
  25. .fi
  26. .PP
  27. .SH "SEE ALSO"
  28. .PP
  29. fIfBSDL_DestroySemaphorefPfR, fIfBSDL_SemWaitfPfR, fIfBSDL_SemTryWaitfPfR, fIfBSDL_SemWaitTimeoutfPfR, fIfBSDL_SemPostfPfR, fIfBSDL_SemValuefPfR
  30. ..." created by instant / docbook-to-man, Tue 11 Sep 2001, 23:00