ExAcquireRundownProtectionEx 함수(wdm.h)
ExAcquireRundownProtectionEx 루틴은 호출자가 개체에 안전하게 액세스할 수 있도록 공유 개체에 대한 런다운 보호를 획득하려고 시도합니다.
통사론
BOOLEAN ExAcquireRundownProtectionEx(
[in, out] PEX_RUNDOWN_REF RunRef,
[in] ULONG Count
);
매개 변수
[in, out] RunRef
ExInitializeRundownProtection 루틴에 대한 이전 호출로 초기화된 EX_RUNDOWN_REF 구조체에 대한 포인터입니다. 런다운 보호 루틴은 이 구조를 사용하여 연결된 공유 개체의 런다운 상태를 추적합니다. 이 구조는 드라이버에 불투명합니다.
[in] Count
개체의 런다운 인스턴스 수로 증분할 크기입니다. 루틴이 TRUE 반환하는 경우에만 수가 증가합니다. 자세한 내용은 비고를 참조하세요.
반환 값
ExAcquireRundownProtectionEx 루틴이 호출자에 대한 런다운 보호를 성공적으로 획득하면 TRUE 반환합니다. 그렇지 않으면 false 반환됩니다. FALSE 반환 값은 개체의 실행이 시작되었으며 개체가 잘못된 것으로 처리되어야 했음을 나타냅니다.
발언
공유 개체에 안전하게 액세스하기 위해 드라이버는 ExAcquireRundownProtectionEx 호출하여 개체에 대한 런다운 보호를 획득합니다.
RunRef 매개 변수는 연결된 개체의 런다운 상태를 추적하는 EX_RUNDOWN_REF 구조를 가리킵니다. 이 상태 정보에는 현재 개체에 적용되는 런다운 보호 인스턴스 수가 포함됩니다. ExAcquireRundownProtectionEx 및 ExReleaseRundownProtectionEx 루틴은 이 수를 임의로 증가시키고 감소합니다. ExAcquireRundownProtection ExReleaseRundownProtection 두 가지 관련 루틴은 이 수를 1씩 증가시키고 감소합니다.
런다운 블록 자체가 페이징되지 않는 한 이 함수는 DISPATCH_LEVEL 호출할 수 있습니다.
자세한 내용은 Run-Down Protection참조하세요.
요구 사항
| 요구 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows Server 2003부터 사용할 수 있습니다. |
| 대상 플랫폼 | 보편적 |
| 헤더 | wdm.h(Wdm.h 포함) |
| 라이브러리 | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | <= DISPATCH_LEVEL(설명 참조) |
| DDI 규정 준수 규칙 | HwStorPortProhibitedDDIs(storport) |