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 |