KsFilterRegisterPowerCallbacks 함수(ks.h)
KsFilterRegisterPowerCallbacks 함수는 필터에 대한 전원 관리 콜백을 등록합니다.
구문
void KsFilterRegisterPowerCallbacks(
[in] PKSFILTER Filter,
[in, optional] PFNKSFILTERPOWER Sleep,
[in, optional] PFNKSFILTERPOWER Wake
);
매개 변수
[in] Filter
전원 콜백을 등록할 KSFILTER 구조체에 대한 포인터입니다. 전원 알림 메시지를 받으려면 필터 가 필터 중심이어야 합니다.
[in, optional] Sleep
디바이스에 대한 절전 모드 요청을 처리하는 함수에 대한 포인터입니다. NULL이면 절전 모드 콜백이 등록되지 않습니다. 자세한 내용은 아래 설명 섹션을 참조하세요.
[in, optional] Wake
디바이스에 대한 절전 모드 해제 요청을 처리하는 함수에 대한 포인터입니다. NULL인 경우 절식 콜백이 지정되지 않습니다. 자세한 내용은 아래 설명 섹션을 참조하세요.
반환 값
없음
설명
경고
절전 모드 또는 절전 모드 해제 콜백 내에서 필터 컨트롤 뮤텍스*를 가져오려고 시도하지 마세요. 또는 교착 상태가 발생할 수 있습니다. 뮤텍스에 대한 자세한 내용은 AVStream의 뮤텍스를 참조하세요.
두 콜백은 다음과 같이 프로토타입화되어야 합니다.
void Sleep/Wake (IN PKSFILTER Filter, IN DEVICE_POWER_STATE State);
필터가 필터 중심 필터이고 디바이스가 절전 모드인 경우 절전 모드 콜백이 이루어집니다. 필터가 필터 중심 필터이고 디바이스가 절전 모드 해제된 경우 절전 모드 해제 콜백이 이루어집니다.
디바이스 전원 상태에 대한 자세한 내용은 디바이스 전원 상태를 참조하세요.
AVStream Minidriver 및필터 중심 처리 초기화를 참조하세요.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Microsoft Windows XP 이상 운영 체제 및 DirectX 8.0 이상 DirectX 버전에서 사용할 수 있습니다. |
| 대상 플랫폼 | 유니버설 |
| 헤더 | ks.h(Ks.h 포함) |
| 라이브러리 | Ks.lib |
| IRQL | PASSIVE_LEVEL |