AcxTargetStreamCreate 函式 （acxtargets.h）

AcxTargetStreamCreate 函式可用來建立目標數據流。

語法

NTSTATUS AcxTargetStreamCreate(
  WDFDEVICE                 Device,
  PWDF_OBJECT_ATTRIBUTES    Attributes,
  PACX_TARGET_STREAM_CONFIG Config,
  ACXTARGETSTREAM           *TargetStream
);

參數

Device

與目前 ACXCIRCUIT 相關聯的 WDFDEVICE 物件（如 Framework 物件的摘要中所述。

Attributes

使用用來設定各種物件值之 WDF_OBJECT_ATTRIBUTES 結構定義的其他屬性：清除和終結回呼、內容類型，以及指定其父物件。

Config

描述目標數據流組態的初始化 ACX_TARGET_STREAM_CONFIG 結構。

TargetStream

接收新 ACXTARGETSTREAM 物件句柄之位置的指標。 如需 ACX 物件的詳細資訊，請參閱 ACX 物件的 摘要。

傳回值

如果呼叫成功，則傳回 STATUS_SUCCESS。 否則，它會傳回適當的錯誤碼。 如需詳細資訊，請參閱使用NTSTATUS值 。

言論

驅動程式應該使用 ACXSTREAMBRIDGE 自動將音訊串流向下傳播至其他連接的線路。

例

    WDF_OBJECT_ATTRIBUTES               attributes;
    PAGGREGATOR_PIN_CONTEXT             pinCtx;
    ACXSTREAM                           stream;
    AGGREGATOR_STREAM_CONTEXT*          streamCtx;
    ACX_TARGET_STREAM_CONFIG            targetStreamCfg;

    streamCtx = GetAggregatorStreamContext(stream);
    ASSERT(streamCtx);
    streamCtx->StreamState = AcxStreamStateStop;

    pinCtx = GetAggregatorPinContext(Pin);

    WDF_OBJECT_ATTRIBUTES_INIT(&attributes);
    attributes.ParentObject = stream;

...

        ACX_TARGET_STREAM_CONFIG_INIT(&targetStreamCfg);
        targetStreamCfg.TargetCircuit = pinCtx->TargetPins[i]->TargetCircuit;
        targetStreamCfg.PinId = pinCtx->TargetPins[i]->TargetPinId;
        targetStreamCfg.DataFormat = StreamFormat;
        targetStreamCfg.SignalProcessingMode = SignalProcessingMode;
        targetStreamCfg.OptionalParameters = VarArguments;

...

        status = AcxTargetStreamCreate(Device, &attributes, &targetStreamCfg, &streamCtx->TargetStreams[i]);

ACX 需求

ACX 最低版本： 1.0

如需 ACX 版本的詳細資訊，請參閱 ACX 版本概觀。

要求

另請參閱

• acxtargets.h 標頭