WDF_DECLARE_CONTEXT_TYPE巨集

[適用於 KMDF 和 UMDF]

WDF_DECLARE_CONTEXT_TYPE巨集會為驅動程序的物件特定內容空間建立名稱和存取子方法。

語法

void WDF_DECLARE_CONTEXT_TYPE(
    _contexttype
);

參數

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

返回值

這個巨集不會傳回值。

備註

如需使用此巨集的詳細資訊，請參閱 Framework 物件內容空間。

範例

下列程式代碼範例會定義要求對象的內容結構（MY_REQUEST_CONTEXT），註冊 結構，然後叫用WDF_DECLARE_CONTEXT_TYPE巨集。 巨集會為內容結構建立存取子方法，並將方法命名為 WdfObjectGet_MY_REQUEST_CONTEXT。

typedef struct _MY_REQUEST_CONTEXT {
  LIST_ENTRY ListEntry;
  WDFMEMORY Memory;
} MY_REQUEST_CONTEXT, *PMY_REQUEST_CONTEXT;

WDF_DECLARE_CONTEXT_TYPE(MY_REQUEST_CONTEXT)

下列程式代碼範例會建立要求對象，然後使用 WdfObjectGet_MY_REQUEST_CONTEXT 存取子方法來取得對象的內容空間指標。

WDFREQUEST Request;
WDF_OBJECT_ATTRIBUTES MyRequestObjectAttributes;
PMY_REQUEST_CONTEXT pMyContext;

WDF_OBJECT_ATTRIBUTES_INIT(&MyRequestObjectAttributes);
WDF_OBJECT_ATTRIBUTES_SET_CONTEXT_TYPE(
                                       &MyRequestObjectAttributes,
                                       MY_REQUEST_CONTEXT
                                       );
status = WdfRequestCreate(
                          &MyRequestObjectAttributes
                          NULL,
                          &Request
                          );
if (!NT_SUCCESS(status)) {
    return status;
}
pMyContext = WdfObjectGet_MY_REQUEST_CONTEXT(Request);

需求

目標平臺	通用
最低 KMDF 版本	1.0
最低UMDF版本	2.0
頁首	Wdfobject.h （包括 Wdf.h）

另請參閱

WdfObjectGetTypedContext

WDF_DECLARE_CONTEXT_TYPE_WITH_NAME