Share via

Función AcxObjectBagRetrieveUI8 (acxmisc.h)

  • Artículo

La función AcxObjectBagRetrieveUI8 recupera un valor ui8 de ocho bytes (ULONG64) de un acxObjectBag inicializado existente que contiene valores.

Sintaxis

NTSTATUS AcxObjectBagRetrieveUI8(
  ACXOBJECTBAG     ObjectBag,
  PCUNICODE_STRING ValueName,
  ULONG64          *Value
);

Parámetros

ObjectBag

Objeto ACX inicializado ObjectBag. Para obtener más información, vea ACX : resumen de objetos ACX.

ValueName

Nombre del valor que se usará para tener acceso al valor.

Value

Valor que se va a recuperar de ObjectBag.

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 Uso de valores NTSTATUS.

Comentarios

Ejemplo

En este ejemplo se muestra el uso de AcxObjectBagRetrieveUI8.

    ACXOBJECTBAG objBag     = NULL;
    ULONG64      ui8Value   = 0;

    //Initialize an object bag configuration
    ACX_OBJECTBAG_CONFIG objBagCfg;
    ACX_OBJECTBAG_CONFIG_INIT(&objBagCfg);
    
    // Set the WDF attributes, and create an object bag 
    WDF_OBJECT_ATTRIBUTES_INIT(&attributes);
    attributes.ParentObject = Circuit;
    RETURN_NTSTATUS_IF_FAILED(AcxObjectBagCreate(&attributes, &objBagCfg, &objBag));

    // Enable deletion of the object bag when the function completes and goes out of scope
    auto objBag_scope = scope_exit([&objBag]() {
        if (objBag != NULL)
        {
            WdfObjectDelete(objBag);
        }
    });

    //Create Properties and add them to an object bag
    DECLARE_CONST_ACXOBJECTBAG_DRIVER_PROPERTY_NAME(VendorX, TestUI8);

    ui8Value = 0x9876543210;
    RETURN_NTSTATUS_IF_FAILED(AcxObjectBagAddUI8(objBag, &TestUI8, ui8Value));

    // Retrieve the value from the object bag
    ui8Value = 0;
    RETURN_NTSTATUS_IF_FAILED(AcxObjectBagRetrieveUI8(objBag, &TestUI8, &ui8Value));

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
Header acxmisc.h
IRQL PASSIVE_LEVEL

Consulte también