KsCreateDefaultClock function (ks.h)

Given an IRP_MJ_CREATE request, the KsCreateDefaultClock function creates a default clock that uses the system clock as a time base and associates the IoGetCurrentIrpStackLocation(Irp)->FileObject with the clock using an internal dispatch table (KSDISPATCH_TABLE). Does not complete the IRP or set the status in the IRP.

The KsCreateDefaultClock function can only be called at PASSIVE_LEVEL.

Syntax

KSDDKAPI NTSTATUS KsCreateDefaultClock(
  [in] PIRP            Irp,
  [in] PKSDEFAULTCLOCK DefaultClock
);

Parameters

[in] Irp

Specifies the IRP with the clock-create request being handled.

[in] DefaultClock

Specifies an initialize default clock structure that is shared among any instance of the default clock for the parent.

Return value

The KsCreateDefaultClock function returns STATUS_SUCCESS if successful, or an error if unsuccessful.

Remarks

The clock can be created after using KsAllocateDefaultClock to create and initialize the internal structures for a default clock instance. After initialization, many file objects can be created against the same underlying default clock instance.

Requirements

See also

KsAllocateDefaultClock