Fungsi AcxObjectBagAddGuid (acxmisc.h)
Fungsi AcxObjectBagAddGuid menambahkan data Guid ke AcxObjectBag yang sudah ada dan diinisialisasi.
Sintaks
NTSTATUS AcxObjectBagAddGuid(
ACXOBJECTBAG ObjectBag,
PCUNICODE_STRING ValueName,
GUID 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 ditambahkan ke 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
Kode di bawah ini menunjukkan penggunaan AcxObjectBagAddGuid.
// Object bag
//
// This obj-bag config setting is shared by all composite/circuit templates.
ACX_OBJECTBAG_CONFIG objBagCfg;
ACX_OBJECTBAG_CONFIG_INIT(&objBagCfg);
WDF_OBJECT_ATTRIBUTES attributes;
WDF_OBJECT_ATTRIBUTES_INIT(&attributes);
attributes.ParentObject = AcxGetManager(NULL);
ACXOBJECTBAG objBag = NULL;
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);
}
});
//
// Add a test unsigned int 4 bytes to the object bag
//
RETURN_NTSTATUS_IF_FAILED(ObjBagAddTestUI4(objBag, 0));
//
// Add unique circuit ID to the object bag
// This unique Id will be picked up by DSP circuit
//
DECLARE_CONST_ACXOBJECTBAG_SYSTEM_PROPERTY_NAME(UniqueID);
GUID uniqueID = { 0 };
RETURN_NTSTATUS_IF_FAILED(RtlGUIDFromString(&circuit_IDs[compositeType], &uniqueID));
RETURN_NTSTATUS_IF_FAILED(AcxObjectBagAddGuid(objBag, &UniqueID, uniqueID));
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
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk