makro WDF_DECLARE_CONTEXT_TYPE

[KMDF ve UMDF için geçerlidir]

WDF_DECLARE_CONTEXT_TYPE makro, sürücünün nesneye özgü bağlam alanı için bir ad ve erişimci yöntemi oluşturur.

Sözdizimi

void WDF_DECLARE_CONTEXT_TYPE(
    _contexttype
);

Parametreler

_contexttype
Bir nesnenin bağlam alanının içeriğini açıklayan sürücü tanımlı bir yapının yapı türü adı.

Dönüş değeri

Bu makro bir değer döndürmez.

Açıklamalar

Bu makro kullanma hakkında daha fazla bilgi için bkz. Framework Nesne Bağlam Alanı.

Örnekler

Aşağıdaki kod örneği, bir istek nesnesi için bağlam yapısını (MY_REQUEST_CONTEXT) tanımlar, yapıyı kaydeder ve ardından WDF_DECLARE_CONTEXT_TYPE makroyu çağırır. Makro bağlam yapısı için bir erişimci yöntemi oluşturur ve yöntemini WdfObjectGet_MY_REQUEST_CONTEXTolarak adlandırmaktadır.

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

WDF_DECLARE_CONTEXT_TYPE(MY_REQUEST_CONTEXT)

Aşağıdaki kod örneği bir istek nesnesi oluşturur ve nesnenin bağlam alanına bir işaretçi almak için WdfObjectGet_MY_REQUEST_CONTEXT erişimci yöntemini kullanır.

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

Gereksinimler

Hedef platform	Evrensel
En düşük KMDF sürümü	1.0
En düşük UMDF sürümü	2.0
Başlık	Wdfobject.h (Wdf.h dahil)

Ayrıca bkz.

WdfObjectGetTypedContext

WDF_DECLARE_CONTEXT_TYPE_WITH_NAME