acxStreamAddElements 函式 (acxstreams.h)
AcxStreamAddElements 可用來將數據流專案新增至 AcxStream。
語法
NTSTATUS AcxStreamAddElements(
ACXSTREAM Stream,
ACXELEMENT *Elements,
ULONG ElementsCount
);
參數
Stream
現有的 ACXSTREAM 物件。 ACXSTREAM 物件代表線路所建立的音訊數據流。 數據流可以包含零個或多個元素。 如需詳細資訊,請參閱 ACX - ACX 物件的摘要。
Elements
一或多個現有 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 版本概觀。
規格需求
需求 | 值 |
---|---|
標頭 | acxstreams.h |
IRQL | PASSIVE_LEVEL |