Función RtlRunOnceBeginInitialize (ntddk.h)

Artículo
02/26/2024

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
STATUS_SUCCESS	La inicialización única ya se ha completado. Los datos inicializados se almacenan en la ubicación de memoria a la que apunta Context .
STATUS_PENDING	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