PFNKSSETTIMER 콜백 함수(ks.h)
스트리밍 미니드라이버의 KStrSetTimer 루틴은 프레젠테이션 시간에 따라 DPC 타이머 콜백을 생성하기 위해 호출됩니다.
구문
PFNKSSETTIMER Pfnkssettimer;
BOOLEAN Pfnkssettimer(
[in] PVOID Context,
[in] PKTIMER Timer,
[in] LARGE_INTEGER DueTime,
[in] PKDPC Dpc
)
{...}
매개 변수
[in] Context
미니드라이버 제공 정보 컨텍스트에 대한 포인터입니다. 미니드라이버가 사용자 지정 DPC 타이머 개체를 할당할 때 미니드라이버가 함수의 DeferredContext 매개 변수에서 KsAllocateDefaultClockEx에 정보 컨텍스트를 전달합니다.
[in] Timer
미니 드라이버에서 할당한 타이머 개체에 대한 포인터입니다.
[in] DueTime
타이머가 만료되는 절대 또는 상대 시간을 지정합니다. DueTime 매개 변수의 값이 음수이면 만료 시간은 현재 시스템 시간을 기준으로 합니다. 그렇지 않으면 만료 시간이 절대입니다. 만료 시간은 시스템 시간 단위(100나노초 간격)로 표시됩니다. 절대 만료 시간은 시스템 시간의 변경 내용을 추적합니다. 상대 만료 시간은 시스템 시간 변경의 영향을 받지 않습니다.
[in] Dpc
KeInitializeDpc를 사용하여 미니드라이버가 초기화한 DPC 개체에 대한 포인터입니다. 이 매개 변수는 선택적 요소입니다.
반환 값
타이머 개체가 시스템 타이머 큐에 이미 있으면 TRUE 를 반환합니다. 그렇지 않으면 가 FALSE를 반환합니다.
설명
미니드라이버에서는 필요에 따라 KStrSetTimer 콜백 함수를 KsAllocateDefaultClockEx에 대한 인수로 제공할 수 있습니다.
일반적으로 미니드라이버가 KStrCorrelatedTime 콜백 함수를 제공하는 경우 미니 드라이버는 KStrSetTimer 콜백 함수도 제공합니다.
미니드라이버가 KStrSetTimer 콜백 함수를 제공하는 경우 함수는 이벤트 알림을 생성하기 위해 델타에 따라 타이머를 현재 프레젠테이션 시간으로 설정해야 합니다.
미니드라이버가 KStrSetTimer 콜백 함수를 제공하는 경우 미니드라이버도 KStrCancelTimer 콜백 함수를 제공하여 타이머를 취소해야 합니다.
제공된 미니드라이버 KStrSetTimer 은 KeSetTimerEx와 동일한 특성을 가져야 합니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 대상 플랫폼 | 데스크톱 |
| 머리글 | ks.h(Ks.h 포함) |