AcxStreamAddElements 関数 (acxstreams.h)

AcxStreamAddElements は、ストリーム要素を AcxStream に追加するために使用されます。

構文

NTSTATUS AcxStreamAddElements(
  ACXSTREAM  Stream,
  ACXELEMENT *Elements,
  ULONG      ElementsCount
);

パラメーター

Stream

既存の ACXSTREAM オブジェクト。 ACXSTREAM オブジェクトは、回線によって作成されたオーディオ ストリームを表します。 ストリームには、0 個以上の要素を含めることができます。 詳細については、「 ACX - ACX オブジェクトの概要」を参照してください。

Elements

1 つ以上の既存の ACXELEMENT オブジェクトの配列へのポインター。

ElementsCount

追加する要素の数。 これは 1 から始まるカウントです。

戻り値

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

解説

例

使用例を次に示します。

    ACX_ELEMENT_CONFIG_INIT(&elementCfg);
    WDF_OBJECT_ATTRIBUTES_INIT_CONTEXT_TYPE(&attributes, ELEMENT_CONTEXT);
 
    attributes.ParentObject = stream;
    status = AcxElementCreate(stream, &attributes, &elementCfg, &elements[0]);
    elementCtx = GetElementContext(elements[0]);
 
    ACX_ELEMENT_CONFIG_INIT(&elementCfg);
    WDF_OBJECT_ATTRIBUTES_INIT_CONTEXT_TYPE(&attributes, ELEMENT_CONTEXT);
 
    attributes.ParentObject = stream;
    status = AcxElementCreate(stream, &attributes, &elementCfg, &elements[1]);
    elementCtx = GetElementContext(elements[1]);
    //
    // Add stream elements
    //
    status = AcxStreamAddElements(stream, elements, SIZEOF_ARRAY(elements));

ACX の要件

最小 ACX バージョン: 1.0

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

要件

要件	値
Header	acxstreams.h
IRQL	PASSIVE_LEVEL

こちらもご覧ください

• acxstreams.h ヘッダー