Метод IWDFInterrupt::SetPolicy (wudfddi.h)

[ предупреждение: UMDF 2 является последней версией UMDF и заменяет UMDF 1. Все новые драйверы UMDF должны быть написаны с помощью UMDF 2. Новые функции не добавляются в UMDF 1, а поддержка UMDF 1 в более новых версиях Windows 10 ограничена. Универсальные драйверы Windows должны использовать UMDF 2. Дополнительные сведения см. в разделе Начало работы с UMDF.]

Метод SetPolicy указывает приоритет прерывания, сходство процессора и политику сходства для указанного прерывания.

Синтаксис

void SetPolicy(
  [in] WDF_INTERRUPT_POLICY   Policy,
  [in] WDF_INTERRUPT_PRIORITY Priority,
  [in] KAFFINITY              TargetProcessorSet
);

Параметры

[in] Policy

Перечислитель WDF_INTERRUPT_POLICYтипа, указывающий политику сопоставления процессора для прерывания.

[in] Priority

Перечислитель WDF_INTERRUPT_PRIORITYтипа, указывающий приоритет прерывания.

[in] TargetProcessorSet

Значение KAFFINITYтипа, указывающее сходство процессора для прерывания, если параметр политики имеет значение WdfIrqPolicySpecifiedProcessors.

Возвращаемое значение

Никакой

Замечания

Начиная с Windows Vista драйверы могут указывать приоритет прерывания, сходство процессора и политику сходства. Дополнительные сведения об использовании реестра для переопределения значений, которые наборов SetPolicy, см. в сходства прерываний и приоритета.

Если драйвер работает в версии операционной системы, которая более ранняя, чем Windows Vista, платформа игнорирует значения, заданные драйвером при вызове SetPolicy.

Дополнительные сведения о значениях реестра и разделах INF, определяющих приоритет прерывания, сходство процессора и политику сходства, см. в разделе Сходство прерываний и приоритет.

Если драйвер вызывает функцию SetPolicy, это необходимо сделать в функции обратного вызова IDriverEntry::OnDeviceAdd обратного вызова после вызова метода IWDFDevice3::CreateInterrupt.

Дополнительные сведения об обработке прерываний в драйверах UMDF см. в доступ к оборудованию и обработке прерываний.

Примеры

Следующий пример кода назначает прерывание устройства обработчику 0 с обычным приоритетом.

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

pIWdfInterrupt->SetPolicy(
                          WdfIrqPolicySpecifiedProcessors,
                          WdfIrqPriorityNormal,
                          AFFINITY_MASK(0)
                          );

Требования

Требование Ценность
завершение поддержки Недоступно в UMDF 2.0 и более поздних версиях.
целевая платформа Настольный
минимальная версия UMDF 1.11
заголовка wudfddi.h
DLL WUDFx.dll

См. также

IWDFInterrupt

KAFFINITY

WDF_INTERRUPT_POLICY

WDF_INTERRUPT_PRIORITY