ACMSTREAMHEADER 結構 (msacm.h)

  • 發行項

ACMSTREAMHEADER結構會定義用來識別轉換資料流程之 ACM 轉換來源和目的地緩衝區配對的標頭。

語法

typedef struct tACMSTREAMHEADER {
  DWORD     cbStruct;
  DWORD     fdwStatus;
  DWORD_PTR dwUser;
  LPBYTE    pbSrc;
  DWORD     cbSrcLength;
  DWORD     cbSrcLengthUsed;
  DWORD_PTR dwSrcUser;
  LPBYTE    pbDst;
  DWORD     cbDstLength;
  DWORD     cbDstLengthUsed;
  DWORD_PTR dwDstUser;
  DWORD     dwReservedDriver[_DRVRESERVED];
} ACMSTREAMHEADER, *PACMSTREAMHEADER, *LPACMSTREAMHEADER;

成員

cbStruct

ACMSTREAMHEADER結構的大小，以位元組為單位。 在應用程式使用此結構呼叫任何 ACM 資料流程函式之前，必須先初始化這個成員。 此成員中指定的大小必須夠大，才能包含基底 ACMSTREAMHEADER 結構。

fdwStatus

旗標，提供轉換緩衝區的相關資訊。 在應用程式呼叫 acmStreamPrepareHeader 函式之前，必須先將這個成員初始化為零，而且不應該在資料流程標頭保持備妥時由應用程式修改。

名稱 描述
ACMSTREAMHEADER_STATUSF_DONE
 由 ACM 或驅動程式設定，以指出它已完成轉換，並將緩衝區傳回至應用程式。
ACMSTREAMHEADER_STATUSF_INQUEUE
 由 ACM 或驅動程式設定，以指出緩衝區已排入佇列以進行轉換。
ACMSTREAMHEADER_STATUSF_PREPARED
 由 ACM 設定，表示已使用 acmStreamPrepareHeader 函式準備緩衝區。

dwUser

使用者資料。 這可以是應用程式所指定的任何實例資料。

pbSrc

來源緩衝區的指標。 當資料流程標頭保持備妥時，此指標必須一律參考相同的位置。 如果應用程式需要變更來源位置，則必須取消準備標頭，並使用替代位置重新準備。

cbSrcLength

pbSrc所指向來源緩衝區的長度，以位元組為單位。 準備標頭時，此成員必須指定來源緩衝區中使用的大小上限。 轉換可以在小於或等於原始備妥大小的來源長度上執行。 不過，當應用程式取消準備標頭時，此成員必須重設為原始大小。

cbSrcLengthUsed

用於轉換的資料量，以位元組為單位。 在轉換完成之前，這個成員無效。 此值可以小於或等於 cbSrcLength。 當移至轉換資料流程的下一個來源資料片段時，應用程式必須使用 cbSrcLengthUsed 成員。

dwSrcUser

使用者資料。 這可以是應用程式所指定的任何實例資料。

pbDst

目的地緩衝區的指標。 當資料流程標頭保持備妥時，此指標必須一律參考相同的位置。 如果應用程式需要變更目的地位置，則必須取消準備標頭，並使用替代位置重新準備。

cbDstLength

pbDst所指向之目的地緩衝區的長度，以位元組為單位。 準備標頭時，此成員必須指定將在目的地緩衝區中使用的大小上限。

cbDstLengthUsed

轉換所傳回的資料量，以位元組為單位。 在轉換完成之前，這個成員無效。 此值可以小於或等於 cbDstLength。 當移至轉換資料流程的下一個目的地位置時，應用程式必須使用 cbDstLengthUsed 成員。

dwDstUser

使用者資料。 這可以是應用程式所指定的任何實例資料。

dwReservedDriver[_DRVRESERVED]

保留;請勿使用。 此成員不需要應用程式初始化，而且在標頭保持備妥時，不應該修改。

備註

必須先使用acmStreamPrepareHeader函式來準備ACMSTREAMHEADER結構才能進行轉換。 當應用程式使用 ACMSTREAMHEADER 結構完成時，必須先呼叫 acmStreamUnprepareHeader 函式，才能釋放來源和目的地緩衝區。

需求

   
最低支援的用戶端 Windows 2000 專業版 [僅限傳統型應用程式]
最低支援的伺服器 Windows 2000 Server [僅限傳統型應用程式]
標頭 msacm.h

另請參閱

音訊壓縮管理員

音訊壓縮結構

acmStreamPrepareHeader

acmStreamUnprepareHeader