acxObjectBagCreate 函式 (acxmisc.h)

AcxObjectBagCreate 函式會建立新的 AcxObjectBag。

語法

NTSTATUS AcxObjectBagCreate(
  PWDF_OBJECT_ATTRIBUTES Attributes,
  PACX_OBJECTBAG_CONFIG  Config,
  ACXOBJECTBAG           *ObjectBag
);

參數

Attributes

使用用來設定各種物件值 之WDF_OBJECT_ATTRIBUTES 結構定義的其他屬性：清除和終結回呼、內容類型，以及指定其父物件。

Config

初始化 ACX_OBJECTBAG_CONFIG 結構的指標。

ObjectBag

初始化的 ObjectBag ACX 物件。 如需詳細資訊，請參閱 ACX - ACX 物件的摘要。

傳回值

如果呼叫成功，則傳 STATUS_SUCCESS 回 。 否則，它會傳回適當的錯誤碼。 如需詳細資訊，請參閱 使用NTSTATUS值。

備註

範例

此範例示範 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);

ACX 需求

最小 ACX 版本： 1.0

如需 ACX 版本的詳細資訊，請參閱 ACX 版本概觀。

規格需求

需求	值
標頭	acxmisc.h
IRQL	PASSIVE_LEVEL

另請參閱

• acxmisc.h 標頭