Condividi tramite


Funzione AcxObjectBagRetrieveBlob (acxmisc.h)

La funzione AcxObjectBagRetrieveBlob recupera un valore blob da un oggetto AcxObjectBag esistente inizializzato che contiene valori.

Sintassi

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

Parametri

ObjectBag

Oggetto ACX ObjectBag inizializzato. Per altre informazioni, vedere ACX - Riepilogo degli oggetti ACX.

ValueName

Nome del valore che verrà utilizzato per accedere al valore.

ValueAttributes

WDF_OBJECT_ATTRIBUTES facoltativo che può essere usato per definire valori ValueAttribute aggiuntivi.

Value

Valore da recuperare da ObjectBag.

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

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 AcxObjectBagRetrieveBlob

Vedere anche