Funzione AcxObjectBagCreate (acxmisc.h)
La funzione AcxObjectBagCreate crea un nuovo AcxObjectBag.
Sintassi
NTSTATUS AcxObjectBagCreate(
PWDF_OBJECT_ATTRIBUTES Attributes,
PACX_OBJECTBAG_CONFIG Config,
ACXOBJECTBAG *ObjectBag
);
Parametri
Attributes
Attributi aggiuntivi definiti usando una struttura WDF_OBJECT_ATTRIBUTES utilizzata per impostare i valori di vari oggetti: pulizia ed eliminazione dei callback, tipo di contesto e per specificare il relativo oggetto padre.
Config
Puntatore alla struttura ACX_OBJECTBAG_CONFIG inizializzata.
ObjectBag
Oggetto ACX ObjectBag inizializzato. Per altre informazioni, vedere ACX - Riepilogo degli oggetti ACX.
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 di valori NTSTATUS.
Osservazioni
Esempio
Questo esempio mostra l'uso di AcxObjectBagCreate.
DECLARE_CONST_UNICODE_STRING(I1Str, L"Value_I1");
// Create a simple object.
ACX_OBJECTBAG_CONFIG_INIT(&cfg1);
WDF_OBJECT_ATTRIBUTES_INIT(&attr);
attr.ParentObject = WdfGetDriver();
status = AcxObjectBagCreate(&attr, &cfg1, &bag1);
if (!NT_SUCCESS(status))
{
ASSERT(FALSE);
goto exit;
}
// Add something to the object bag
status = AcxObjectBagAddI1(bag1, &I1Str, cValue);
Requisiti ACX
versione minima di ACX: 1.0
Per altre informazioni sulle versioni di ACX, vedere panoramica della versione ACX.
Fabbisogno
| Requisito | Valore |
|---|---|
| intestazione | acxmisc.h |
| IRQL | PASSIVE_LEVEL |