RtlRunOnceExecuteOnce 함수(ntddk.h)

RtlRunOnceExecuteOnce는 일회성 초기화를 수행합니다.

구문

NTSYSAPI NTSTATUS RtlRunOnceExecuteOnce(
  PRTL_RUN_ONCE         RunOnce,
  PRTL_RUN_ONCE_INIT_FN InitFn,
  PVOID                 Parameter,
  PVOID                 *Context
);

매개 변수

[in, out] RunOnce

RTL_RUN_ONCE 일회성 초기화 구조에 대한 포인터입니다.

[in] InitFn

RunOnceInitialization 루틴에 대한 포인터입니다.

[in, out] Parameter

RunOnceInitialization 루틴에 Parameter 매개 변수로 전달할 값입니다.

[out] Context

초기화된 데이터를 수신하는 PVOID 변수에 대한 포인터입니다.

반환 값

RtlRunOnceExecuteOnce 는 작업이 성공하면 STATUS_SUCCESS 반환하고, 작업이 실패하면 적절한 NTSTATUS 오류 코드를 반환합니다.

설명

특정 RTL_RUN_ONCE 구조에 대한 RtlRunOnceExecuteOnce에 대한 첫 번째 호출의 경우 RtlRunOnceExecuteOnce는 RunOnceInitialization 루틴을 호출하여 데이터를 초기화합니다. 해당 구조체에 대한 RtlRunOnceExecuteOnce 에 대한 모든 후속 호출은 동일한 초기화된 데이터를 제공합니다. RunOnceInitialization 루틴은 동일한 RTL_RUN_ONCE 구조에 대해 두 번 호출되지 않습니다.

RtlRunOnceExecuteOnce는 일반 커널 APC가 비활성화된 상태에서 실행됩니다. APC_LEVEL 모든 호출이 발생하지 않는 한 특수 커널 APC 내에서 루틴을 호출해서는 안 됩니다.

요구 사항

추가 정보

RTL_RUN_ONCE

RtlRunOnceBeginInitialize

RtlRunOnceComplete

RtlRunOnceInitialize

RunOnceInitialization