共用方式為


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 ,以指定架構將指派給它為驅動程式建立的要求對象內容空間。 如需此內容空間的詳細資訊,請參閱 使用要求對象內容

架構不會針對驅動程式呼叫 WdfRequestCreateWdfRequestCreateFromIrp 時所建立的要求物件使用指定的物件屬性。

您的驅動程式必須先從其 EvtDriverDeviceAdd 回呼函式內呼叫 WdfDeviceInitSetRequestAttributes,才能呼叫 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
                                  );

規格需求

需求
目標平台 Universal
最小 KMDF 版本 1.0
最低UMDF版本 2.0
標頭 wdfdevice.h (包含 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