WdfDeviceInitSetRequestAttributes 函数 (wdfdevice.h)

  • 项目

[适用于 KMDF 和 UMDF]

WdfDeviceInitSetRequestAttributes 方法设置对象属性，这些属性将用于框架从设备的 I/O 队列传递到驱动程序的所有框架请求对象。

语法

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

参数

[in] DeviceInit

调用方提供的指向 WDFDEVICE_INIT 结构的指针。

[in] RequestAttributes

指向调用方分配 的WDF_OBJECT_ATTRIBUTES 结构的指针，该结构包含设备请求对象的属性。

返回值

无

备注

驱动程序可以调用 WdfDeviceInitSetRequestAttributes 来指定框架将分配给它为驱动程序创建的请求对象的对象上下文空间。 有关此上下文空间的详细信息，请参阅 使用请求对象上下文。

框架不会对驱动程序调用 WdfRequestCreate 或 WdfRequestCreateFromIrp 时创建的请求对象使用指定的对象属性。

驱动程序必须先从其 EvtDriverDeviceAdd 回调函数中调用 WdfDeviceInitSetRequestAttributes，然后才能调用 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
                                  );

要求

要求 值
目标平台 通用
最低 KMDF 版本 1.0
最低 UMDF 版本 2.0
标头 wdfdevice.h (包括 Wdf.h)
Library 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