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

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

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

Синтаксис

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

Параметры

[in] DeviceInit

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

[in] RequestAttributes

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

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

None

Remarks

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

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

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

Примеры

В следующем примере кода инициализируется структура 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
                                  );

Требования

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

EvtDriverDeviceAdd