WDF_DECLARE_CUSTOM_TYPE makro

Článek
2025-03-22

[Platí pro KMDF a UMDF]

Makro WDF_DECLARE_CUSTOM_TYPE vytvoří název a metodu přístupového objektu pro vlastní typ ovladače.

Syntaxe

void WDF_DECLARE_CUSTOM_TYPE(
    _customtype
);

Parametry

_customtype
Název vlastního typu definovaný ovladačem.

Návratová hodnota

Toto makro nevrací hodnotu.

Poznámky

Při volání WDF_DECLARE_CUSTOM_TYPEovladač definuje vlastní název typu. Při výběru vlastního názvu typu zvolte název, který je specifický pro doménu ovladače. Jako konvenci nezahajujte vlastní název typu s předponou Wdf.

Další informace o vlastních typech objektů naleznete v tématu Framework Objekt vlastní typy.

Příklady

Následující příklad kódu volá makro WDF_DECLARE_CUSTOM_TYPE deklaruje název MY_CUSTOM_TYPE vlastního typu. Ovladač musí tento řádek umístit do oblasti ovladače, která deklaruje globální data, obvykle do hlavičkového souboru.

WDF_DECLARE_CUSTOM_TYPE(MY_CUSTOM_TYPE)

Následující příklad kódu vytvoří objekt požadavku a pak používá WdfObjectAddCustomType metoda přidružení MY_CUSTOM_TYPE vlastního typu k objektu požadavku.

WDFREQUEST Request;
WDF_OBJECT_ATTRIBUTES MyRequestObjectAttributes;

WDF_OBJECT_ATTRIBUTES_INIT(&MyRequestObjectAttributes);

status = WdfRequestCreate(
                          &MyRequestObjectAttributes
                          NULL,
                          &Request
                          );

if (!NT_SUCCESS(status)) {
    return status;
}

status = WdfObjectAddCustomType(
                          Request,
                          MY_CUSTOM_TYPE
                          );

if (!NT_SUCCESS(status)) {
    return status;
}

Požadavky

Cílová platforma	univerzální
Minimální verze SLUŽBY KMDF	1.11
Minimální verze UMDF	2.0
Záhlaví	Wdfobject.h (včetně Wdf.h)

Viz také

WdfObjectAddCustomType

WdfObjectAddCustomTypeWithData

WdfObjectGetCustomTypeData

WdfObjectIsCustomType

Sdílet prostřednictvím