Функция IoInitializeIrp (wdm.h)

Статья
08/08/2023

Подпрограмма IoInitializeIrp инициализирует заданный IRP, выделенный вызывающим объектом.

Синтаксис

void IoInitializeIrp(
  [in, out] PIRP   Irp,
  [in]      USHORT PacketSize,
  [in]      CCHAR  StackSize
);

Параметры

[in, out] Irp

Указатель на IRP, который необходимо инициализировать.

[in] PacketSize

Указывает размер IRP в байтах.

[in] StackSize

Указывает количество расположений стека в IRP.

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

None

Remarks

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

Драйверы могут использовать IoInitializeIrp для повторной инициализации IRP для повторного использования только при определенных обстоятельствах. Дополнительные сведения см. в разделе Повторное использованием IRP .

Если драйвер связывает MDL с выделенной им IRP, драйвер отвечает за освобождение MDL после завершения IRP.

Драйвер промежуточного или верхнего уровня также может вызывать IoBuildDeviceIoControlRequest, IoBuildAsynchronousFsdRequest или IoBuildSynchronousFsdRequest для настройки запросов, отправляемых драйверам более низкого уровня. Только драйвер самого высокого уровня может вызывать IoMakeAssociatedIrp.

Требования

Требование	Значение
Минимальная версия клиента	Доступно начиная с Windows 2000.
Целевая платформа	Универсальное
Верхняя часть	wdm.h (включая Wdm.h, Ntddk.h, Ntifs.h)
Библиотека	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	<= DISPATCH_LEVEL
Правила соответствия DDI	HwStorPortProhibitedDDIs(storport), IoReuseIrp(wdm)