共用方式為


WDF_OBJECT_ATTRIBUTES_INIT_CONTEXT_TYPE宏

[適用於 KMDF 和 UMDF]

WDF_OBJECT_ATTRIBUTES_INIT_CONTEXT_TYPE宏會初始化驅動程式的WDF_OBJECT_ATTRIBUTES結構,並將對象的驅動程式定義內容資訊插入結構中。

語法

void WDF_OBJECT_ATTRIBUTES_INIT_CONTEXT_TYPE(
    _attributes,
    _contexttype
);

參數

_屬性
WDF_OBJECT_ATTRIBUTES 結構的指標。

_contexttype
描述物件內容空間內容的驅動程式定義結構型別名稱。

傳回值

此宏不會傳回值。

備註

呼叫 WDF_OBJECT_ATTRIBUTES_INIT_CONTEXT_TYPE之前,您必須呼叫 WDF_DECLARE_CONTEXT_TYPE全域WDF_DECLARE_CONTEXT_TYPE_WITH_NAME (不在函式) 內。

WDF_OBJECT_ATTRIBUTES_INIT_CONTEXT_TYPE宏結合了WDF_OBJECT_ATTRIBUTES_INIT函式和WDF_OBJECT_ATTRIBUTES_SET_CONTEXT_TYPE宏。

範例

下列程式代碼範例會定義WDM_NDIS_REQUEST內容結構。 然後,此範例會叫用 WDF_DECLARE_CONTEXT_TYPE_WITH_NAME 宏來註冊 結構,並指定內容存取子方法將會命名為 RequestGetMyContext。 然後,在函式中,此範例會配置 WDF_OBJECT_ATTRIBUTES 結構,然後初始化 WDF_OBJECT_ATTRIBUTES 結構。

typedef struct _WDM_NDIS_REQUEST
{
   PMP_ADAPTER  Adapter;
   NDIS_OID  Oid;
   NDIS_REQUEST_TYPE  RequestType;
   PVOID  InformationBuffer;
   ULONG  InformationBufferLength;
   PULONG  BytesReadOrWritten;
   PULONG  BytesNeeded;
} WDM_NDIS_REQUEST, *PWDM_NDIS_REQUEST;

WDF_DECLARE_CONTEXT_TYPE_WITH_NAME(WDM_NDIS_REQUEST, RequestGetMyContext);

// above are in global space

...

WDF_OBJECT_ATTRIBUTES  attributes;

WDF_OBJECT_ATTRIBUTES_INIT_CONTEXT_TYPE( &attributes, WDM_NDIS_REQUEST );

規格需求

目標平台

Universal

最小 KMDF 版本

1.0

最低UMDF版本

2.0

標頭

Wdfobject.h (包含 Wdf.h)

另請參閱

WDF_OBJECT_ATTRIBUTES

WDF_OBJECT_ATTRIBUTES_INIT

WDF_OBJECT_ATTRIBUTES_SET_CONTEXT_TYPE