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。 如需詳細資訊，請參閱 建立 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