Partilhar via

Função AcxObjectBagRetrieveBlob (acxmisc.h)

  • Artigo

A função AcxObjectBagRetrieveBlob recupera um valor de blob de um AcxObjectBag inicializado existente que contém valores.

Sintaxe

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

Parâmetros

ObjectBag

Um objeto ACX do ObjectBag inicializado. Para obter mais informações, consulte ACX – Resumo dos objetos ACX.

ValueName

O nome do valor que será usado para acessar o valor.

ValueAttributes

WDF_OBJECT_ATTRIBUTES opcionais que podem ser usadas para definir ValueAttributes adicionais.

Value

O valor a ser recuperado do ObjectBag.

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 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);

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 AcxObjectBagRetrieveBlob

Consulte também