Funzione AcxObjectBagRetrieveI8 (acxmisc.h)
La funzione AcxObjectBagRetrieveI8 recupera un valore I8 (LONG64) di otto byte da un acxObjectBag esistente inizializzato che contiene valori.
Sintassi
NTSTATUS AcxObjectBagRetrieveI8(
ACXOBJECTBAG ObjectBag,
PCUNICODE_STRING ValueName,
LONG64 *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 illustra l'uso di AcxObjectBagRetrieveI8.
ACXOBJECTBAG objBag = NULL;
LONG64 i8Value = 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, TestI8);
i8Value = 0x9876543210;
RETURN_NTSTATUS_IF_FAILED(AcxObjectBagAddI8(objBag, &TestI8, i8Value));
// Retrieve the value from the object bag
i8Value = 0;
RETURN_NTSTATUS_IF_FAILED(AcxObjectBagRetrieveI8(objBag, &TestI8, &i8Value));
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 |