Функция WdfRequestGetInformation (wdfrequest.h)

Статья
08/08/2023

[Относится к KMDF и UMDF]

Метод WdfRequestGetInformation возвращает сведения о состоянии завершения для указанного запроса ввода-вывода.

Синтаксис

ULONG_PTR WdfRequestGetInformation(
  [in] WDFREQUEST Request
);

Параметры

[in] Request

Дескриптор объекта запроса платформы.

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

WdfRequestGetInformation возвращает сведения, заданные драйвером более низкого уровня, путем вызова WdfRequestSetInformation или WdfRequestCompleteWithInformation.

Ошибка проверка возникает, если драйвер предоставляет недопустимый дескриптор объекта.

Драйвер может вызвать WdfRequestSetInformation или WdfRequestCompleteWithInformation , чтобы задать сведения о состоянии завершения для запроса ввода-вывода. Драйвер может вызвать WdfRequestGetInformation после того, как драйвер более низкого уровня завершит запрос, чтобы получить сведения о состоянии выполнения, заданные драйвером нижнего уровня.

Если драйвер вызывает WdfRequestGetInformation после вызова WdfRequestComplete для выполнения запроса, WdfRequestGetInformation возвращает значение NULL.

Дополнительные сведения о WdfRequestGetInformation см. в разделе Завершение запросов ввода-вывода.

Примеры

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

ULONG_PTR  informationRetrieved = NULL;

status = WdfIoTargetSendWriteSynchronously(
                                           ioTarget,
                                           request,
                                           &outputMemoryDescriptor,
                                           NULL,
                                           NULL,
                                           &bytesWritten
                                           );
if (NT_SUCCESS(status)) {
    informationRetrieved = WdfRequestGetInformation(request);
}

Требования

Требование	Значение
Целевая платформа	Универсальное
Минимальная версия KMDF	1,0
Минимальная версия UMDF	2,0
Верхняя часть	wdfrequest.h (включая Wdf.h)
Библиотека	Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL	<=DISPATCH_LEVEL
Правила соответствия DDI	DriverCreate(kmdf), InvalidReqAccess(kmdf), InvalidReqAccessLocal(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

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

WdfRequestCompleteWithInformation

WdfRequestSetInformation

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