Función KsAllocateDefaultClock (ks.h)
La función KsAllocateDefaultClock asigna e inicializa la estructura de reloj predeterminada.
Sintaxis
KSDDKAPI NTSTATUS KsAllocateDefaultClock(
[out] PKSDEFAULTCLOCK *DefaultClock
);
Parámetros
[out] DefaultClock
Especifica la estructura de reloj compartida asignada por el autor de la llamada. La hora actual se establece en cero y el estado se establece en KSSTATE_STOP. Tras completar correctamente esta rutina, la estructura indicada por este puntero contendrá una referencia al reloj predeterminado. Los datos devueltos deben tratarse como opacos y reservados para el uso del sistema.
Valor devuelto
La función KsAllocateDefaultClock devuelve STATUS_SUCCESS si se ejecuta correctamente o un error de memoria si no se realiza correctamente.
Observaciones
El elemento DefaultClock.ReferenceCount interno se inicializa en uno mediante la función KsAllocateDefaultClock. El elemento se incrementa y disminuye a medida que cada DPC de notificación se pone en cola y se completa. Cuando se va a liberar la estructura, el elemento se usa para determinar si el propietario del reloj debe liberar la estructura o si un DPC pendiente debe liberarlo de forma asincrónica.
Cuando el reloj ya no es necesario, el controlador debe llamar a KsFreeDefaultClock para liberar los recursos asignados para su uso con el reloj.
Requisitos
| Requisito | Valor |
|---|---|
| de la plataforma de destino de | Universal |
| encabezado de | ks.h (incluya Ks.h) |
| biblioteca de | Ks.lib |
| irQL | PASSIVE_LEVEL |