WDF_OBJECT_ATTRIBUTES_INIT_CONTEXT_TYPE宏

發行項
02/08/2024

[適用於 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 );