AcxObjectBagRetrieveBlob-Funktion (acxmisc.h)
Die AcxObjectBagRetrieveBlob-Funktion ruft einen Blobwert aus einem vorhandenen initialisierten AcxObjectBag-Objekt ab, das 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-Objekten.
ValueName
Der Name des Werts, der für den Zugriff auf den Wert verwendet wird.
ValueAttributes
Optional WDF_OBJECT_ATTRIBUTES, die zum Definieren zusätzlicher ValueAttributes verwendet werden können.
Value
Der Wert, der aus dem ObjectBag abgerufen werden soll.
Rückgabewert
Gibt zurück STATUS_SUCCESS
, wenn der Aufruf erfolgreich war. Andernfalls wird ein entsprechender Fehlercode zurückgegeben. Weitere Informationen finden Sie unter Verwenden von NTSTATUS-Werten.
Bemerkungen
Beispiel
In diesem Beispiel wird die Verwendung von AcxObjectBagRetrieveBlob veranschaulicht.
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
AcX-Mindestversion: 1.0
Weitere Informationen zu ACX-Versionen finden Sie unter ACX-Versionsübersicht.
Anforderungen
Anforderung | Wert |
---|---|
Header | acxmisc.h |
IRQL | AcxObjectBagRetrieveBlob |