Función RtlRunOnceBeginInitialize (ntddk.h)
La rutina RtlRunOnceBeginInitialize comienza una inicialización única.
Sintaxis
NTSYSAPI NTSTATUS RtlRunOnceBeginInitialize(
[in, out] PRTL_RUN_ONCE RunOnce,
[in] ULONG Flags,
[out] PVOID *Context
);
Parámetros
[in, out] RunOnce
Puntero a la estructura de inicialización única de RTL_RUN_ONCE .
[in] Flags
Opcionalmente, los controladores pueden especificar una o varias de las marcas siguientes:
RTL_RUN_ONCE_ASYNC
Realizar la inicialización de forma asincrónica. El controlador puede realizar varios intentos de finalización en paralelo. Si se usa esta marca, se producirá un error en las llamadas posteriores a esta rutina a menos que también se especifique esta marca.
RTL_RUN_ONCE_CHECK_ONLY
No comience la inicialización, pero compruebe si ya se ha producido la inicialización. Si RtlRunOnceBeginInitialize devuelve STATUS_SUCCESS, la inicialización se realizó correctamente y *Context contiene los datos inicializados.
[out] Context
Especifica un puntero a una variable PVOID que recibe los datos inicializados. El valor de *Context solo es válido cuando la rutina devuelve STATUS_SUCCESS.
Valor devuelto
RtlRunOnceBeginInitialize devuelve uno de los siguientes valores NTSTATUS:
| Código devuelto | Descripción |
|---|---|
|
La inicialización única ya se ha completado. Los datos inicializados se almacenan en la ubicación de memoria a la que apunta Context . |
|
El autor de la llamada ha comenzado correctamente la inicialización única. El autor de la llamada ahora realiza los pasos de inicialización específicos del controlador y, a continuación, llama a RtlRunOnceComplete para completar la inicialización. |
Comentarios
Los controladores también pueden realizar una inicialización única llamando a RtlRunOnceExecuteOnce y proporcionando una rutina RunOnceInitialization .
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Disponible en Windows Vista y versiones posteriores de Windows. |
| Plataforma de destino | Universal |
| Encabezado | ntddk.h (incluya Ntddk.h) |
| Library | NtosKrnl.lib |
| Archivo DLL | NtosKrnl.exe |
| IRQL | <= APC_LEVEL |