次の方法で共有

AcxObjectBagRetrieveBlob 関数 (acxmisc.h)

  • [アーティクル]

AcxObjectBagRetrieveBlob 関数は、値を含む既存の初期化された AcxObjectBag から BLOB 値を取得します。

構文

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

パラメーター

ObjectBag

初期化された ObjectBag ACX オブジェクト。 詳細については、ACX - ACX オブジェクトの概要を参照してください。

ValueName

値へのアクセスに使用される値の名前。

ValueAttributes

追加の ValueAttribute を定義するために使用できる省略可能なWDF_OBJECT_ATTRIBUTES。

Value

ObjectBag から取得する値。

戻り値

呼び出しが成功した場合に STATUS_SUCCESS を返します。 それ以外の場合は、適切なエラー コードが返されます。 詳細については、NTSTATUS 値 の使用に関するを参照してください。

備考

例

この例では、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 の要件

最小 ACX バージョン: 1.0

ACX バージョンの詳細については、ACX バージョンの概要 参照してください。

必要条件

要件 価値
ヘッダー acxmisc.h
IRQL AcxObjectBagRetrieveBlob

関連項目

  • acxmisc.h ヘッダー を する