Bagikan melalui

Fungsi AcxObjectBagRetrieveI8 (acxmisc.h)

  • Artikel

Fungsi AcxObjectBagRetrieveI8 mengambil nilai int eight byte I8 (LONG64) dari AcxObjectBag yang sudah ada dan diinisialisasi yang berisi nilai.

Sintaks

NTSTATUS AcxObjectBagRetrieveI8(
  ACXOBJECTBAG     ObjectBag,
  PCUNICODE_STRING ValueName,
  LONG64           *Value
);

Parameter

ObjectBag

Objek ACX ObjectBag yang diinisialisasi. Untuk informasi selengkapnya, lihat ACX - Ringkasan Objek ACX.

ValueName

Nama nilai yang akan digunakan untuk mengakses nilai.

Value

Nilai yang akan diambil dari ObjectBag.

Menampilkan nilai

Mengembalikan STATUS_SUCCESS jika panggilan berhasil. Jika tidak, ia mengembalikan kode kesalahan yang sesuai. Untuk informasi selengkapnya, lihat Menggunakan Nilai NTSTATUS.

Keterangan

Contoh

Contoh ini menunjukkan penggunaan 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));

Persyaratan ACX

Versi ACX minimum: 1.0

Untuk informasi selengkapnya tentang versi ACX, lihat Gambaran umum versi ACX.

Persyaratan

Persyaratan Nilai
Header acxmisc.h
IRQL PASSIVE_LEVEL

Lihat juga