AcxStreamGetElementById 函式 (acxstreams.h)

  • 發行項

AcxStreamGetElementById 函式會傳回所要求專案標識碼的 ACXELEMENT 物件句柄。 如需 ACX 對象的詳細資訊，請參閱 ACX 物件摘要。

語法

ACXELEMENT AcxStreamGetElementById(
  ACXSTREAM Stream,
  ULONG     ElementId
);

參數

Stream

現有的 ACXSTREAM 物件。 ACXSTREAM 物件代表線路所建立的音訊數據流。

ElementId

所要求項目的標識碼。

傳回值

所要求專案的 ACXELEMENT 物件句柄，如果 ACXSTREAM 沒有具有指定識別碼的 ACXELEMENT，則為 NULL。

備註

範例

範例使用方式如下所示。

    ULONGLONG               index       = GetMessageContext(Event); // Context is an index.
    ACXELEMENT              element     = nullptr;
    //
    // Get the ACX element.
    //
    element = AcxStreamGetElementById(Stream, (ULONG)index);

ACX 需求

最低 ACX 版本： 1.0

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

規格需求

需求 值
標頭 acxstreams.h
IRQL <= DISPATCH_LEVEL

另請參閱