Edit

AcxStreamInitAssignProperties function (acxstreams.h)

  • Article

The AcxStreamInitAssignProperties function assigns an array of properties to a stream using an ACXSTREAM_INIT object.

Syntax

NTSTATUS AcxStreamInitAssignProperties(
  PACXSTREAM_INIT    StreamInit,
  PACX_PROPERTY_ITEM Properties,
  ULONG              PropertiesCount
);

Parameters

StreamInit

Defined by a ACXSTREAM_INIT object, that is used to define the stream initialization. For more information about ACX Objects, see ACX - Summary of ACX Objects.

Properties

An array of ACX_PROPERTY_ITEM structures that describe the requested property sets, properties and flags.

PropertiesCount

A one based count of the number of Properties in the Properties array.

Return value

Returns STATUS_SUCCESS if the call was successful. Otherwise, it returns an appropriate error code. For more information, see Using NTSTATUS Values.

Remarks

Example

Example usage is shown below.


    ACX_PROPERTY_ITEM StreamProperties[] =
    {
        {
            &KSPROPSETID_DrmAudioStream,
            KSPROPERTY_DRMAUDIOSTREAM_CONTENTID,
            ACX_PROPERTY_ITEM_FLAG_SET,
            Codec_EvtStreamSetContentId,
            NULL,  // Reserved
            sizeof(KSP_DRMAUDIOSTREAM_CONTENTID) - sizeof(KSPROPERTY), // ControlCb
            sizeof(KSDRMAUDIOSTREAM_CONTENTID), // ValueCb
        }, 
    };

    ULONG StreamPropertiesCount = SIZEOF_ARRAY(StreamProperties);

    status = AcxStreamInitAssignProperties(StreamInit,
                                           StreamProperties,
                                           StreamPropertiesCount);

ACX requirements

Minimum ACX version: 1.0

For more information about ACX versions, see ACX version overview.

Requirements

Requirement Value
Header acxstreams.h
IRQL PASSIVE_LEVEL

See also