WdfObjectGetTypedContext-macro

Artikel
2025-03-22

[Van toepassing op KMDF en UMDF]

De WdfObjectGetTypedContext macro retourneert een aanwijzer naar de contextruimte van een object.

Syntaxis

PVOID WdfObjectGetTypedContext(
    Handle,
    Type
);

Parameterwaarden

Hendel
Een ingang naar een frameworkobject.

Typ
De symboolnaam van een door het stuurprogramma gedefinieerde structuur die de contextruimte van een object beschrijft.

Retourwaarde

WdfObjectGetTypedContext retourneert een aanwijzer naar de contextruimte van het opgegeven object.

Opmerkingen

U kunt de WdfObjectGetTypedContext macro gebruiken om een aanwijzer te verkrijgen naar de contextruimte van een frameworkobject. Gebruik deze macro als alternatief voor het aanroepen van een objectspecifieke contexttoegangsmethode die is gemaakt door de WDF_DECLARE_CONTEXT_TYPE macro of de WDF_DECLARE_CONTEXT_TYPE_WITH_NAME macro. Als u WdfObjectGetTypedContextgebruikt, moet u nog steeds WDF_DECLARE_CONTEXT_TYPE of WDF_DECLARE_CONTEXT_TYPE_WITH_NAME gebruiken om de objectcontext te declareren.

Zie Contextruimte voor frameworkobjectenvoor meer informatie over deze macro's.

Voorbeelden

In het volgende codevoorbeeld wordt een contextstructuur (MY_REQUEST_CONTEXT) voor een aanvraagobject gedefinieerd en wordt de structuur vervolgens geregistreerd.

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

WDF_DECLARE_CONTEXT_TYPE(MY_REQUEST_CONTEXT)

In het volgende codevoorbeeld wordt een aanvraagobject gemaakt en wordt een aanwijzer naar de contextruimte opgehaald.

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 = WdfObjectGetTypedContext(
                                      Request,
                                      MY_REQUEST_CONTEXT
                                      );

Vereisten

Doelplatform	Universal
Minimale KMDF-versie	1.0
Minimale UMDF-versie	2.0
Koptekst	Wdfobject.h (inclusief Wdf.h)
Bibliotheek	Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL	Elk niveau

Zie ook

WDF_DECLARE_CONTEXT_TYPE

WDF_DECLARE_CONTEXT_TYPE_WITH_NAME

Delen via