Función AcxObjectBagCreate (acxmisc.h)
La función AcxObjectBagCreate crea un nuevo AcxObjectBag.
Sintaxis
NTSTATUS AcxObjectBagCreate(
PWDF_OBJECT_ATTRIBUTES Attributes,
PACX_OBJECTBAG_CONFIG Config,
ACXOBJECTBAG *ObjectBag
);
Parámetros
Attributes
Atributos adicionales definidos mediante una estructura de WDF_OBJECT_ATTRIBUTES que se usan para establecer los valores de varios objetos: limpieza y destrucción de devoluciones de llamada, tipo de contexto y para especificar su objeto primario.
Config
Puntero a la estructura de ACX_OBJECTBAG_CONFIG inicializada.
ObjectBag
Objeto ACX inicializado ObjectBag. Para obtener más información, vea ACX - Resumen de objetos ACX.
Valor devuelto
Devuelve STATUS_SUCCESS
si la llamada se realizó correctamente. De lo contrario, devuelve un código de error adecuado. Para obtener más información, vea Using NTSTATUS Values.
Observaciones
Ejemplo
En este ejemplo se muestra el uso de 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);
Requisitos de ACX
versión mínima de ACX: 1.0
Para obtener más información sobre las versiones de ACX, consulte introducción a la versión de ACX.
Requisitos
Requisito | Valor |
---|---|
encabezado de | acxmisc.h |
irQL | PASSIVE_LEVEL |