struktur XAPO_REGISTRATION_PROPERTIES (xapo.h)

Artikel
03/04/2024

Menjelaskan karakteristik umum XAPO. Digunakan dengan IXAPO::GetRegistrationProperties, CXAPOParametersBase::CXAPOParametersBase, dan CXAPOBase::CXAPOBase.

Sintaks

typedef struct XAPO_REGISTRATION_PROPERTIES {
  CLSID  clsid;
  WCHAR  FriendlyName[XAPO_REGISTRATION_STRING_LENGTH];
  WCHAR  CopyrightInfo[XAPO_REGISTRATION_STRING_LENGTH];
  UINT32 MajorVersion;
  UINT32 MinorVersion;
  UINT32 Flags;
  UINT32 MinInputBufferCount;
  UINT32 MaxInputBufferCount;
  UINT32 MinOutputBufferCount;
  UINT32 MaxOutputBufferCount;
} XAPO_REGISTRATION_PROPERTIES;

Anggota

clsid

ID kelas COM untuk digunakan dengan fungsi CoCreateInstance.

FriendlyName[XAPO_REGISTRATION_STRING_LENGTH]

Nama yang mudah diingat, string unicode.

CopyrightInfo[XAPO_REGISTRATION_STRING_LENGTH]

Informasi hak cipta, string unicode.

MajorVersion

Nomor versi utama.

MinorVersion

Nomor versi minor.

Flags

Bendera properti XAPO yang menjelaskan karakteristik umum perilaku proses. Bendera ini dijelaskan dalam tabel berikut.

Bendera	Deskripsi
XAPO_FLAG_INPLACE_SUPPORTED	XAPO mendukung pemrosesan di tempat: buffer aliran input dan buffer aliran output dapat menjadi buffer yang sama tergantung pada input. Misalnya, pertimbangkan efek yang dapat dijalankan dalam mode stereo ke 5.1 atau mono ke mono. Ketika diatur ke stereo ke 5.1, itu akan dijalankan dengan buffer input dan output terpisah karena konversi format tidak diizinkan di tempat. Namun, jika dikonfigurasi untuk menjalankan mono ke mono, XAPO yang sama dapat dijalankan di tempat. Dengan demikian implementasi yang sama dapat digunakan kembali dengan mudah untuk berbagai konfigurasi input/output, sambil memanfaatkan pemrosesan di tempat jika memungkinkan.
XAPO_FLAG_INPLACE_REQUIRED	XAPO memerlukan pemrosesan di tempat: buffer aliran input dan buffer aliran output harus buffer yang sama. Ketika XAPO_FLAG_INPLACE_REQUIRED digunakan, XAPO tidak dapat melakukan konversi format.
XAPO_FLAG_CHANNELS_MUST_MATCH	Jumlah saluran aliran input dan output harus cocok.
XAPO_FLAG_FRAMERATE_MUST_MATCH	Laju bingkai aliran input dan output harus cocok.
XAPO_FLAG_BITSPERSAMPLE_MUST_MATCH	Kedalaman bit dan ukuran kontainer aliran input dan output harus cocok.
XAPO_FLAG_BUFFERCOUNT_MUST_MATCH	Jumlah buffer input dan output harus cocok, berlaku untuk XAPO_LOCKFORPROCESS_BUFFER_PARAMETERS. Saat bendera XAPO_FLAG_BUFFERCOUNT_MUST_MATCH diatur XAPO_REGISTRATION_PROPERTIES. MinInputBufferCount harus sama dengan XAPO_REGISTRATION_PROPERTIES. MinOutputBufferCount dan XAPO_REGISTRATION_PROPERTIES. MaxInputBufferCount harus sama dengan XAPO_REGISTRATION_PROPERTIES. MaxOutputBufferCount.
XAPOBASE_DEFAULT_FLAG	XAPO_FLAG_CHANNELS_MUST_MATCH \| XAPO_FLAG_FRAMERATE_MUST_MATCH \| XAPO_FLAG_BITSPERSAMPLE_MUST_MATCH \| XAPO_FLAG_BUFFERCOUNT_MUST_MATCH \| XAPO_FLAG_INPLACE_SUPPORTED

MinInputBufferCount

Jumlah minimum aliran input yang diperlukan untuk pemrosesan.

MaxInputBufferCount

Jumlah maksimum aliran input yang diperlukan untuk pemrosesan.

CatatanMaxInputBufferCount saat ini terbatas pada nilai 1.

MinOutputBufferCount

Jumlah minimum aliran output yang diperlukan untuk pemrosesan.

MaxOutputBufferCount

Jumlah maksimum aliran output yang diperlukan untuk pemrosesan.

CatatanMaxOutputBufferCount saat ini terbatas pada nilai 1.

Keterangan

Persyaratan Platform

Windows 10 (XAudio2.9); Windows 8, Windows Phone 8 (XAudio 2.8); DirectX SDK (XAudio 2.7)

Persyaratan

Persyaratan	Nilai
Header	xapo.h

Lihat juga

Struktur

Bagikan melalui