DMDLL_SetPowerManagement

DMIICORE 드라이버의 파워정책결정을 지시합니다. 윈도우 시스템이 절전모드로 진입하거나 다시 회복할때 드라이버는 이에 맞는 적절한 하드웨어세팅을 수정할 필요가 있습니다. 이런 경우를 지원하기 위해서 DM II 는 콜백등록을 지원하고 있습니다. 이 함수를 사용해서 등록하는 콜백함수는 DMDLL_CloseDevice()함수를 호출하기전까지 윈도우의 파워모드가 변경되는 시기마다 등록하는 pfnPMNotifyCallback 콜백함수가 호출됩니다. 이와 같은 등록작업을 하지 않으면 윈도우의 파워모드가 변경되는 시기에 DMIICORE 드라이버에 의해서 내부적으로 처리됩니다

Description

int DMDLL_SetPowerManagement( 
    IN DMHANDLE            MasterHandle,
    IN PFNPMNOTIFYCALLBACK pfnPMNotifyCallback,
    IN PVOID               pContext
)

Parameters

MasterHandle
    작업중이던 디바이스 핸들, DMDLL_OpenDeviceForInterfaceDeviceStack( PipeNumber = -1 )함수를 통해서 얻은 핸들(Master)이어야 한다
pfnPMNotifyCallback
    윈도우가 파워모드를 변경할때 마다 호출되는 함수. NULL은 해제하는 의미를 가집니다
pContext
    pfnPMNotifyCallback 콜백함수가 호출될때 함께 전달되는 파라미터

Return Values

return  int
    작업이 성공할 경우 DMSTAT_SUCCESS 리턴

Changelog

Examples

int nRet = 0;

nRet = DMDLL_SetPowerManagement(MasterHandle, PowerChangingCallback, NULL);