Condividi tramite

Funzione AcxObjectBagRetrieveUI8 (acxmisc.h)

  • Articolo

La funzione AcxObjectBagRetrieveUI8 recupera un valore UI8 (ULONG64) senza segno da un valore AcxObjectBag inizializzato esistente che contiene valori.

Sintassi

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

Parametri

ObjectBag

Oggetto ACX ObjectBag inizializzato. Per altre informazioni, vedere ACX - Riepilogo degli oggetti ACX.

ValueName

Nome del valore che verrà utilizzato per accedere al valore.

Value

Valore da recuperare da ObjectBag.

Valore restituito

Restituisce STATUS_SUCCESS se la chiamata ha avuto esito positivo. In caso contrario, restituisce un codice di errore appropriato. Per altre informazioni, vedere Uso dei valori NTSTATUS.

Commenti

Esempio

Questo esempio mostra l'uso di 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));

Requisiti di ACX

Versione minima di ACX: 1.0

Per altre informazioni sulle versioni ACX, vedere La panoramica della versione di ACX.

Requisiti

Requisito Valore
Intestazione acxmisc.h
IRQL PASSIVE_LEVEL

Vedi anche