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

Статья
02/07/2025

[Применимо к 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

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