WdfInterruptSetExtendedPolicy 함수(wdfinterrupt.h)

[KMDF 및 UMDF에 적용]

WdfInterruptSetExtendedPolicy 메서드는 지정된 인터럽트에 대한 인터럽트 우선 순위, 프로세서 선호도, 선호도 정책 및 프로세서 그룹을 지정합니다.

구문론

VOID WdfInterruptSetExtendedPolicy(
  [in] WDFINTERRUPT                   Interrupt,
  [in] PWDF_INTERRUPT_EXTENDED_POLICY PolicyAndGroup
);

매개 변수

[in] Interrupt

프레임워크 인터럽트 개체에 대한 핸들입니다.

[in] PolicyAndGroup

호출자가 할당하고 초기화하는 WDF_INTERRUPT_EXTENDED_POLICY 구조체에 대한 포인터입니다.

반환 값

없음

비고

드라이버에서 잘못된 개체 핸들을 제공하면 버그 검사가 수행됩니다.

Windows Vista 이상 버전의 운영 체제에서는 드라이버가 WdfInterruptSetPolicy 메서드를 사용하여 인터럽트의 우선 순위, 프로세서 선호도 및 선호도 정책을 지정할 수 있습니다. 또한 KMDF 버전 1.9 이상에서는 드라이버가 WdfInterruptSetExtendedPolicy 메서드를 사용하여 인터럽트의 우선 순위, 프로세서 선호도, 선호도 정책 및 프로세서 그룹을 지정할 수 있습니다.

레지스트리를 사용하여 WdfInterruptSetExtendedPolicy 집합에 값을 재정의하는 방법에 대한 자세한 내용은 인터럽트 선호도 및 우선 순위참조하세요.

드라이버가 Windows 7 이전의 운영 체제 버전에서 실행되는 경우 프레임워크는 WdfInterruptSetExtendedPolicy호출할 때 드라이버가 프로세서 그룹 번호에 대해 지정하는 값을 무시합니다.

드라이버가 Windows Vista 이전의 운영 체제 버전에서 실행되는 경우 프레임워크는 WdfInterruptSetPolicy 호출하거나 WdfInterruptSetExtendedPolicy 때 드라이버가 지정하는 모든 값을 무시합니다.

인터럽트의 우선 순위, 프로세서 선호도 및 선호도 정책을 지정하는 레지스트리 값 및 INF 섹션에 대한 자세한 내용은 인터럽트 선호도 및 우선 순위참조하세요.

드라이버가 WdfInterruptSetExtendedPolicy 호출하는 경우 일반적으로 WdfInterruptCreate호출한 후 EvtDriverDeviceAdd 콜백 함수에서 호출됩니다.

드라이버가 EvtDevicePrepareHardware인터럽트를 만드는 경우 WdfInterruptSetPolicy 사용하거나 WdfInterruptSetExtendedPolicy 사용하지 마세요. 대신 이 콜백 함수가 IoResourceRequirementsList 매개 변수에서 수신하는 인터럽트 리소스 요구 사항을 직접 조작하여 EvtDeviceFilterAddResourceRequirements정책을 적용할 수 있습니다.

프레임워크 기반 드라이버에서 인터럽트 처리에 대한 자세한 내용은 하드웨어 인터럽트 처리참조하세요.

예시

다음 코드 예제에서는 WDF_INTERRUPT_EXTENDED_POLICY_INIT 호출하여 WDF_INTERRUPT_EXTENDED_POLICY 구조를 초기화합니다. 정책, 우선 순위 및 대상 프로세서 집합에 대한 값을 설정합니다. WdfInterruptSetExtendedPolicy 호출합니다. 이 예제에서는 인터럽트에서 정상 우선 순위를 설정하고 프로세서 그룹 2의 프로세서 0에 인터럽트(interrupt)를 할당합니다.

#define AFFINITY_MASK(n) ((ULONG_PTR)1 << (n))

WDF_INTERRUPT_EXTENDED_POLICY myExtendedPolicy;

WDF_INTERRUPT_EXTENDED_POLICY_INIT(&myExtendedPolicy);
myExtendedPolicy.Policy = WdfIrqPolicySpecifiedProcessors;
myExtendedPolicy.Priority = WdfIrqPriorityNormal;
myExtendedPolicy.TargetProcessorSetAndGroup.Mask = AFFINITY_MASK(0);
myExtendedPolicy.TargetProcessorSetAndGroup.Group = 2;

WdfInterruptSetExtendedPolicy(
                              Interrupt,
                              &myExtendedPolicy
 );

요구 사항

참고하십시오

WdfInterruptSetPolicy