Функция AcxObjectBagRetrieveBlob (acxmisc.h)

Статья
02/26/2024

Функция AcxObjectBagRetrieveBlob извлекает значение большого двоичного объекта из существующего инициализированного AcxObjectBag, содержащего значения.

Синтаксис

NTSTATUS AcxObjectBagRetrieveBlob(
  ACXOBJECTBAG           ObjectBag,
  PCUNICODE_STRING       ValueName,
  PWDF_OBJECT_ATTRIBUTES ValueAttributes,
  WDFMEMORY              *Value
);

Параметры

ObjectBag

Инициализированный объект ObjectBag ACX. Дополнительные сведения см. в разделе ACX — сводка по объектам ACX.

ValueName

Имя значения, которое будет использоваться для доступа к значению.

ValueAttributes

Необязательный WDF_OBJECT_ATTRIBUTES, который можно использовать для определения дополнительных атрибутов ValueAttributes.

Value

Значение, извлекаемое из ObjectBag.

Возвращаемое значение

Возвращает значение STATUS_SUCCESS , если вызов был успешным. В противном случае возвращается соответствующий код ошибки. Дополнительные сведения см. в разделе Использование значений NTSTATUS.

Remarks

Пример

В этом примере показано использование AcxObjectBagRetrieveBlob.

    WDFMEMORY vendorPropertiesBlock = NULL;
    PVOID vendorPropertiesBuffer = NULL;
    size_t vendorPropertiesSize = 0;
    NTSTATUS status = STATUS_NOT_FOUND;

    PAGED_CODE();

    //
    // Retrieve the vendor blob from the CircuitProperties object bag.
    //
    RETURN_NTSTATUS_IF_FAILED(AcxObjectBagRetrieveBlob(CircuitProperties, &VendorPropertiesBlock, NULL, &vendorPropertiesBlock));

    vendorPropertiesBuffer = WdfMemoryGetBuffer(vendorPropertiesBlock, &vendorPropertiesSize);

Требования ACX

Минимальная версия ACX: 1.0

Дополнительные сведения о версиях ACX см. в статье Обзор версий ACX.

Требования

Требование	Значение
Заголовок	acxmisc.h
IRQL	AcxObjectBagRetrieveBlob

См. также раздел

Заголовок acxmisc.h

Поделиться через