функция обратного вызова PINTERFACE_DEREFERENCE (wdm.h)

Статья
02/29/2024

Подпрограмма InterfaceDereference уменьшает количество ссылок в интерфейсе, определяемом драйвером.

Синтаксис

PINTERFACE_DEREFERENCE PinterfaceDereference;

void PinterfaceDereference(
  [in] PVOID Context
)
{...}

Параметры

[in] Context

Указатель на сведения о контексте для конкретного интерфейса. Вызывающий объект передает значение, передаваемое в качестве элемента Context структуры INTERFACE для интерфейса.

Обратите внимание, что подпрограмма InterfaceDereference является контрактом интерфейса для каждого интерфейса, поэтому общих требований IRQL для ее вызова нет.

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

None

Remarks

Вы можете использовать подпрограмму InterfaceReference для увеличения количества ссылок для интерфейса.

Драйвер, импортируемый интерфейс, отвечает за вызов подпрограммы InterfaceDereference для уменьшения числа ссылок после того, как драйвер больше не использует интерфейс. Например, драйвер, запрашивающий указатель на интерфейс, отправляя запрос IRP_MN_QUERY_INTERFACE , вызывает InterfaceDereference. Кроме того, драйвер, получающий указатель на интерфейс на другой драйвер, должен вызывать InterfaceDereference.

Требования

Требование	Значение
Целевая платформа	Персональный компьютер
Верхняя часть	wdm.h (включает Wdm.h, Ntddk.h, Ntifs.h, Miniport.h, Wudfwdm.h)

См. также раздел

ИНТЕРФЕЙС

IRP_MN_QUERY_INTERFACE

InterfaceReference

Поделиться через