KsAllocateDefaultClock 함수는 기본 클록 구조를 할당하고 초기화합니다.
통사론
KSDDKAPI NTSTATUS KsAllocateDefaultClock(
[out] PKSDEFAULTCLOCK *DefaultClock
);
매개 변수
[out] DefaultClock
호출자가 할당한 공유 기본 클록 구조를 지정합니다. 현재 시간은 0으로 설정되고 상태는 KSSTATE_STOP 설정됩니다. 이 루틴이 성공적으로 완료되면 이 포인터로 표시된 구조체에 기본 클록에 대한 참조가 포함됩니다. 반환된 데이터는 불투명한 것으로 처리되고 시스템 사용을 위해 예약되어야 합니다.
반환 값
KsAllocateDefaultClock 함수는 성공하면 STATUS_SUCCESS 반환하고, 실패하면 메모리 오류를 반환합니다.
발언
내부 DefaultClock.ReferenceCount 요소는 KsAllocateDefaultClock 함수에 의해 하나로 초기화됩니다. 각 알림 DPC가 큐에 대기되고 완료되면 요소가 증가 및 감소됩니다. 구조체를 해제할 때 요소는 클록 소유자가 구조를 해제해야 하는지 또는 보류 중인 DPC가 비동기적으로 해제해야 하는지 여부를 결정하는 데 사용됩니다.
클록이 더 이상 필요하지 않은 경우 드라이버는 KsFreeDefaultClock 호출하여 시계와 함께 사용하기 위해 할당된 리소스를 해제해야 합니다.
요구 사항
| 요구 | 값 |
|---|---|
| 대상 플랫폼 | 보편적 |
| 헤더 | ks.h(Ks.h 포함) |
| 라이브러리 | Ks.lib |
| IRQL | PASSIVE_LEVEL |