WDF_OBJECT_ATTRIBUTES_INIT_CONTEXT_TYPE巨集

發行項
03/22/2025

[適用於 KMDF 和 UMDF]

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

語法

void WDF_OBJECT_ATTRIBUTES_INIT_CONTEXT_TYPE(
    _attributes,
    _contexttype
);

參數

_attributes
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 );