Função AcxObjectBagCreate (acxmisc.h)
A função AcxObjectBagCreate cria um novo AcxObjectBag.
Sintaxe
NTSTATUS AcxObjectBagCreate(
PWDF_OBJECT_ATTRIBUTES Attributes,
PACX_OBJECTBAG_CONFIG Config,
ACXOBJECTBAG *ObjectBag
);
Parâmetros
Attributes
Atributos adicionais definidos usando uma estrutura WDF_OBJECT_ATTRIBUTES usada para definir valores de vários objetos: limpar e destruir retornos de chamada, tipo de contexto e especificar seu objeto pai.
Config
Um ponteiro para a estrutura de ACX_OBJECTBAG_CONFIG inicializada.
ObjectBag
Um objeto ACX do ObjectBag inicializado. Para obter mais informações, consulte ACX – Resumo dos objetos ACX.
Valor de retorno
Retorna STATUS_SUCCESS se a chamada foi bem-sucedida. Caso contrário, ele retornará um código de erro apropriado. Para obter mais informações, consulte Usando valores NTSTATUS.
Observações
Exemplo
Este exemplo mostra o uso de 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);
Requisitos do ACX
versão mínima do ACX: 1.0
Para obter mais informações sobre versões do ACX, consulte visão geral da versão do ACX.
Requisitos
| Requisito | Valor |
|---|---|
| cabeçalho | acxmisc.h |
| IRQL | PASSIVE_LEVEL |