DriverCallback 함수(mmiscapi.h)

  • 아티클

콜백 함수를 호출하거나, 창에 메시지를 보내거나, 스레드 차단을 해제합니다. 작업은 알림 플래그의 값에 따라 달라집니다. 이 함수는 설치 가능한 드라이버의 DriverProc 함수 내에서만 사용됩니다.

구문

BOOL DriverCallback(
  DWORD_PTR dwCallback,
  DWORD     dwFlags,
  HDRVR     hDevice,
  DWORD     dwMsg,
  DWORD_PTR dwUser,
  DWORD_PTR dwParam1,
  DWORD_PTR dwParam2
);

매개 변수

dwCallback

dwFlags 매개 변수에 지정된 플래그에 따라 콜백 함수, 창 핸들 또는 작업 핸들의 주소입니다.

dwFlags

알림 플래그 다음 값 중 하나일 수 있습니다.

값 의미
DCB_NOSWITCH
 시스템이 스택을 전환할 수 없게 됩니다. 이 값은 콜백 함수에 충분한 스택 공간이 있는 것으로 알려진 경우에만 사용됩니다.
DCB_FUNCTION
 dwCallback 매개 변수는 애플리케이션 정의 콜백 함수의 주소입니다. 시스템은 콜백 함수에 콜백 메시지를 보냅니다.
DCB_WINDOW
 dwCallback 매개 변수는 애플리케이션 정의 창의 핸들입니다. 시스템은 창에 후속 알림을 보냅니다.
DCB_TASK
 dwCallback 매개 변수는 애플리케이션 또는 작업의 핸들입니다. 시스템은 애플리케이션 또는 작업에 후속 알림을 보냅니다.

hDevice

설치 가능한 드라이버 instance 핸들입니다.

dwMsg

메시지 값입니다.

dwUser

디바이스를 열 때 애플리케이션에서 제공하는 32비트 사용자 instance 데이터입니다.

dwParam1

32비트 메시지 종속 매개 변수입니다.

dwParam2

32비트 메시지 종속 매개 변수입니다.

반환 값

매개 변수가 잘못되었거나 작업의 메시지 큐가 가득 차면 성공하면 TRUE 를 반환하고 FALSE 를 반환합니다.

설명

클라이언트는 디바이스를 열 때 알리는 방법을 지정합니다. DCB_FUNCTION 및 DCB_WINDOW 플래그는 디바이스를 열 때 DRV_OPEN 메시지의 lParam2 매개 변수에 지정된 CALLBACK_FUNCTION 및 CALLBACK_WINDOW 해당 플래그의 상위 단어와 동일합니다.

콜백 함수를 사용하여 알림이 수행되면 hdrvr, msg, dwUser, dwParam1 및 dwParam2 가 콜백 함수에 전달됩니다. 창을 통해 알림이 수행되면 msg, hdrvr 및 dwParam1 만 창에 전달됩니다.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버 Windows 2000 Server[데스크톱 앱만]
대상 플랫폼 Windows
헤더 mmiscapi.h(Mmiscapi.h 포함)
라이브러리 Winmm.lib
DLL Winmm.dll

추가 정보

드라이버 함수

설치 가능한 드라이버