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

  • Статья

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

Синтаксис

PINTERFACE_REFERENCE PinterfaceReference;

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

Параметры

[in] Context

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

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

None

Remarks

Обратите внимание, что это контракт для каждого интерфейса, поэтому общие требования IRQL к InterfaceReference/Dereference отсутствуют.

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

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

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

Требования

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

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

ИНТЕРФЕЙС

IRP_MN_QUERY_INTERFACE

InterfaceDereference