Функция WdfDeviceInitSetRequestAttributes (wdfdevice.h)

Статья
02/07/2025

[Применимо к KMDF и UMDF]

Метод WdfDeviceInitSetRequestAttributes задает атрибуты объектов, которые будут использоваться для всех объектов запроса платформы, которые платформа доставляет драйверу из очередей ввода-вывода устройства.

Синтаксис

void WdfDeviceInitSetRequestAttributes(
  [in] PWDFDEVICE_INIT        DeviceInit,
  [in] PWDF_OBJECT_ATTRIBUTES RequestAttributes
);

Параметры

[in] DeviceInit

Вызывающий указатель на структуру WDFDEVICE_INIT.

[in] RequestAttributes

Указатель на структуру, выделенную вызывающим объектом, WDF_OBJECT_ATTRIBUTES, которая содержит атрибуты для объектов запроса устройства.

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

Никакой

Замечания

Драйвер может вызывать WdfDeviceInitSetRequestAttributes, чтобы указать пространство контекста объекта, которое платформа будет назначать объектам запроса, создаваемым для драйвера. Дополнительные сведения об этом пространстве контекста см. в использовании контекста объекта запроса.

Платформа не использует указанные атрибуты объекта для объектов запроса, создаваемых при вызове драйвера WdfRequestCreate или WdfRequestCreateFromIrp.

Драйвер должен вызывать WdfDeviceInitSetRequestAttributes из функции обратного вызова EvtDriverDeviceAdd перед вызовом WdfDeviceCreate. Дополнительные сведения см. в создании объекта устройства Framework.

Примеры

Следующий пример кода инициализирует структуру WDF_OBJECT_ATTRIBUTES и вызывает WdfDeviceInitSetRequestAttributes.

typedef struct _REQUEST_CONTEXT {
  ULONG_PTR  Information;
} REQUEST_CONTEXT, *PREQUEST_CONTEXT;
WDF_OBJECT_ATTRIBUTES  attributes;

WDF_OBJECT_ATTRIBUTES_INIT_CONTEXT_TYPE(
                                        &attributes,
                                        REQUEST_CONTEXT
                                        );
WdfDeviceInitSetRequestAttributes(
                                  DeviceInit,
                                  &attributes
                                  );

Требования

Требование	Ценность
целевая платформа	Всеобщий
минимальная версия KMDF	1.0
минимальная версия UMDF	2.0
заголовка	wdfdevice.h (include Wdf.h)
библиотеки	Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL	<= DISPATCH_LEVEL
правил соответствия DDI	ChildDeviceInitAPI(kmdf), ControlDeviceInitAPI(kmdf), DeviceInitAPI(kmdf), DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf), PdoDeviceInitAPI(kmdf)

См. также

EvtDriverDeviceAdd

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