AcxObjectBagRetrieveBlob-Funktion (acxmisc.h)

  • Artikel

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

Weitere Informationen