KsAllocateDefaultClock 함수(ks.h)

KsAllocateDefaultClock 함수는 기본 클록 구조를 할당하고 초기화합니다.

구문

KSDDKAPI NTSTATUS KsAllocateDefaultClock(
  [out] PKSDEFAULTCLOCK *DefaultClock
);

매개 변수

[out] DefaultClock

호출자가 할당한 공유 기본 클록 구조를 지정합니다. 현재 시간은 0으로 설정되고 상태는 KSSTATE_STOP. 이 루틴이 성공적으로 완료되면 이 포인터로 표시된 구조체에 기본 클록에 대한 참조가 포함됩니다. 반환된 데이터는 불투명한 것으로 처리되고 시스템 사용을 위해 예약되어야 합니다.

반환 값

KsAllocateDefaultClock 함수는 성공하면 STATUS_SUCCESS 반환하고, 성공하지 못하면 메모리 오류를 반환합니다.

설명

내부 DefaultClock.ReferenceCount 요소는 KsAllocateDefaultClock 함수에 의해 하나로 초기화됩니다. 각 알림 DPC가 큐에 대기되고 완료되면 요소가 증가 및 감소됩니다. 구조체를 해제할 때 요소는 클록의 소유자가 구조를 해제해야 하는지 또는 보류 중인 DPC가 비동기적으로 해제해야 하는지 여부를 결정하는 데 사용됩니다.

클록이 더 이상 필요하지 않은 경우 드라이버는 KsFreeDefaultClock 을 호출하여 클록에 사용하기 위해 할당된 모든 리소스를 해제해야 합니다.

요구 사항

추가 정보

KsAllocateDefaultClockEx

KsFreeDefaultClock