AcxObjectBagRetrieveBlob-Funktion (acxmisc.h)
Die AcxObjectBagRetrieveBlob-Funktion ruft einen BLOB-Wert aus einem vorhandenen, initialisierten AcxObjectBag ab, der Werte enthält.
Syntax
NTSTATUS AcxObjectBagRetrieveBlob(
ACXOBJECTBAG ObjectBag,
PCUNICODE_STRING ValueName,
PWDF_OBJECT_ATTRIBUTES ValueAttributes,
WDFMEMORY *Value
);
Parameter
ObjectBag
Ein initialisiertes ObjectBag ACX-Objekt. Weitere Informationen finden Sie unter ACX – Zusammenfassung von ACX Objects.
ValueName
Der Name des Werts, der für den Zugriff auf den Wert verwendet wird.
ValueAttributes
Optionaler WDF_OBJECT_ATTRIBUTES, der zum Definieren zusätzlicher ValueAttributes verwendet werden kann.
Value
Der wert, der aus dem ObjectBag abgerufen werden soll.
Rückgabewert
Gibt STATUS_SUCCESS zurück, wenn der Anruf erfolgreich war. Andernfalls wird ein entsprechender Fehlercode zurückgegeben. Weitere Informationen finden Sie unter Verwenden von NTSTATUS-Werten.
Bemerkungen
Beispiel
Dieses Beispiel zeigt die Verwendung von 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-Anforderungen
Mindestens ACX-Version: 1.0
Weitere Informationen zu ACX-Versionen finden Sie unter ACX-Versionsübersicht.
Anforderungen
| Anforderung | Wert |
|---|---|
| Header- | acxmisc.h |
| IRQL- | AcxObjectBagRetrieveBlob |