AcxStreamGetElementById 関数 (acxstreams.h)

AcxStreamGetElementById 関数は、要求された要素 ID の ACXELEMENT オブジェクト ハンドルを返します。 ACX オブジェクトの詳細については、「 ACX - ACX オブジェクトの概要」を参照してください。

構文

ACXELEMENT AcxStreamGetElementById(
  ACXSTREAM Stream,
  ULONG     ElementId
);

パラメーター

Stream

既存の ACXSTREAM オブジェクト。 ACXSTREAM オブジェクトは、回線によって作成されたオーディオ ストリームを表します。

ElementId

要求された要素の ID。

戻り値

要求された要素の ACXELEMENT オブジェクト ハンドル。ACXSTREAM に指定された ID を持つ 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 バージョンの概要」を参照してください。

要件

要件
Header acxstreams.h
IRQL <= DISPATCH_LEVEL

こちらもご覧ください