Funzione AcxObjectBagAddGuid (acxmisc.h)
La funzione AcxObjectBagAddGuid aggiunge dati Guid a un oggetto AcxObjectBag inizializzato esistente.
Sintassi
NTSTATUS AcxObjectBagAddGuid(
ACXOBJECTBAG ObjectBag,
PCUNICODE_STRING ValueName,
GUID 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 aggiungere a 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
Il codice seguente illustra l'uso di 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));
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 |