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 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 dei valori NTSTATUS.
Commenti
Esempio
In questo esempio viene illustrato 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 di ACX
Versione minima di ACX: 1.0
Per altre informazioni sulle versioni ACX, vedere La panoramica della versione di ACX.
Requisiti
| Requisito | Valore |
|---|---|
| Intestazione | acxmisc.h |
| IRQL | AcxObjectBagRetrieveBlob |