AcxObjectBagCreate-Funktion (acxmisc.h)
Mit der AcxObjectBagCreate-Funktion wird ein neues AcxObjectBag-Objekt erstellt.
Syntax
NTSTATUS AcxObjectBagCreate(
PWDF_OBJECT_ATTRIBUTES Attributes,
PACX_OBJECTBAG_CONFIG Config,
ACXOBJECTBAG *ObjectBag
);
Parameter
Attributes
Zusätzliche Attribute, die mithilfe einer WDF_OBJECT_ATTRIBUTES Struktur definiert werden, die zum Festlegen der Werte verschiedener Objekte verwendet werden: Bereinigen und Zerstören von Rückrufen, Kontexttyp und Angeben des übergeordneten Objekts.
Config
Ein Zeiger auf die initialisierte ACX_OBJECTBAG_CONFIG Struktur.
ObjectBag
Ein initialisiertes ObjectBag ACX-Objekt. Weitere Informationen finden Sie unter ACX – Zusammenfassung von ACX Objects.
Rückgabewert
Gibt STATUS_SUCCESS zurück, wenn der Anruf erfolgreich war. Andernfalls wird ein entsprechender Fehlercode zurückgegeben. Weitere Informationen finden Sie unter Verwenden von NTSTATUS-Werten.
Bemerkungen
Beispiel
Dieses Beispiel zeigt die Verwendung von AcxObjectBagCreate.
DECLARE_CONST_UNICODE_STRING(I1Str, L"Value_I1");
// Create a simple object.
ACX_OBJECTBAG_CONFIG_INIT(&cfg1);
WDF_OBJECT_ATTRIBUTES_INIT(&attr);
attr.ParentObject = WdfGetDriver();
status = AcxObjectBagCreate(&attr, &cfg1, &bag1);
if (!NT_SUCCESS(status))
{
ASSERT(FALSE);
goto exit;
}
// Add something to the object bag
status = AcxObjectBagAddI1(bag1, &I1Str, cValue);
ACX-Anforderungen
Mindestens ACX-Version: 1.0
Weitere Informationen zu ACX-Versionen finden Sie unter ACX-Versionsübersicht.
Anforderungen
| Anforderung | Wert |
|---|---|
| Header- | acxmisc.h |
| IRQL- | PASSIVE_LEVEL |