функция обратного вызова IO_CSQ_REMOVE_IRP (wdm.h)
Подпрограмма CsqRemoveIrp используется системой для удаления указанного IRP из реализованной драйвером, безопасной для отмены очереди IRP.
Синтаксис
IO_CSQ_REMOVE_IRP IoCsqRemoveIrp;
void IoCsqRemoveIrp(
[in] PIO_CSQ Csq,
[in] PIRP Irp
)
{...}
Параметры
[in] Csq
Указатель на структуру IO_CSQ для очереди IRP с безопасной отменой.
[in] Irp
Указатель на IRP, удаляемую из очереди IRP.
Возвращаемое значение
None
Remarks
Драйвер указывает подпрограмму CsqRemoveIrp для безопасной с отменой очереди IRP при инициализации структуры IO_CSQ очереди. Драйвер указывает подпрограмму в качестве параметра CsqRemoveIrpioCsqInitialize или IoCsqInitializeEx при инициализации IO_CSQ. Дополнительные сведения см. в разделе Отмена безопасных очередей IRP.
Подпрограммы IoCsqRemoveIrp и IoCsqRemoveNextIrp вызывают подпрограмму CsqRemoveIrp очереди IRP с отменой, чтобы удалить указанную IRP из очереди. Система также использует CsqRemoveIrp для удаления отмененного IRP из очереди.
Примеры
Чтобы определить подпрограмму обратного вызова CsqRemoveIrp , необходимо сначала предоставить объявление функции, определяющее тип определяемой процедуры обратного вызова. Windows предоставляет набор типов функций обратного вызова для драйверов. Объявление функции с помощью типов функций обратного вызова помогает анализу кода для драйверов, средству проверки статических драйверов (SDV) и другим средствам проверки находить ошибки, и это требование для написания драйверов для операционной системы Windows.
Например, чтобы определить подпрограмму обратного вызова CsqRemoveIrp с именем MyCsqRemoveIrp, используйте тип IO_CSQ_REMOVE_IRP, как показано в следующем примере кода:
IO_CSQ_REMOVE_IRP MyCsqRemoveIrp;
Затем реализуйте процедуру обратного вызова следующим образом:
_Use_decl_annotations_
VOID
MyCsqRemoveIrp(
PIO_CSQ Csq,
PIRP Irp
)
{
// Function body
}
Тип функции IO_CSQ_REMOVE_IRP определен в файле заголовка Wdm.h. Чтобы более точно определить ошибки при запуске средств анализа кода, обязательно добавьте заметку в _Use_decl_annotations_ определение функции. Заметка _Use_decl_annotations_ гарантирует, что будут использоваться заметки, которые применяются к типу функции IO_CSQ_REMOVE_IRP в файле заголовка. Дополнительные сведения о требованиях к объявлениям функций см. в разделе Объявление функций с помощью типов ролей функций для драйверов WDM. Дополнительные сведения о _Use_decl_annotations_см. в статье Поведение функции с заметками.
Требования
| Требование | Значение |
|---|---|
| Целевая платформа | Персональный компьютер |
| Верхняя часть | wdm.h (включая Wdm.h, Ntddk.h, Ntifs.h) |