struktur PCPIN_DESCRIPTOR (portcls.h)

Artikel
02/27/2024

Struktur PCPIN_DESCRIPTOR menjelaskan pabrik pin.

Sintaks

typedef struct {
  ULONG                    MaxGlobalInstanceCount;
  ULONG                    MaxFilterInstanceCount;
  ULONG                    MinFilterInstanceCount;
  const PCAUTOMATION_TABLE *AutomationTable;
  KSPIN_DESCRIPTOR         KsPinDescriptor;
} PCPIN_DESCRIPTOR, *PPCPIN_DESCRIPTOR;

Anggota

MaxGlobalInstanceCount

Menentukan berapa kali maksimum global jenis pin ini dapat diinstansiasi. Maksimum global menghitung jumlah instans pin yang dapat didukung driver adaptor di semua instans filter. Hitungan dapat diatur ke nol untuk menunjukkan bahwa pin tidak dapat diinstansiasi. Nilai ULONG(-1) menunjukkan pin dapat diinstansiasi beberapa kali. Nilai lain menunjukkan berapa kali pin dapat diinstansiasi.

MaxFilterInstanceCount

Menentukan berapa kali maksimum pin dapat diinstansiasi pada satu instans filter. Hitungan dapat diatur ke nol untuk menunjukkan bahwa pin tidak dapat diinstansiasi. Nilai ULONG(-1) menunjukkan pin dapat diinstansiasi beberapa kali. Nilai lain menunjukkan berapa kali pin dapat diinstansiasi.

MinFilterInstanceCount

Menentukan berapa kali pin perlu diinstansiasi pada instans filter. Anggota ini adalah batas bawah yang pasti pada jumlah instans pin yang harus ada agar filter dapat berfungsi.

AutomationTable

Arahkan ke tabel otomatisasi. Anggota ini adalah penunjuk ke struktur jenis PCAUTOMATION_TABLE. Pointer dapat berupa NULL untuk menunjukkan bahwa tidak ada otomatisasi yang didukung. Tabel otomatisasi menentukan handler untuk properti dan peristiwa milik instans pin.

KsPinDescriptor

Menjelaskan pabrik pin. Anggota ini adalah struktur jenis KSPIN_DESCRIPTOR. Pabrik pin dapat memiliki antarmuka nol dan media nol. Daftar antarmuka diabaikan dalam semua kasus. Daftar standar-menengah akan default ke daftar yang hanya berisi I/O perangkat (KSMEDIUM_STANDARD_DEVIO).

Keterangan

Struktur ini digunakan untuk menggambarkan masing-masing pabrik pin yang diterapkan driver miniport. Struktur PCFILTER_DESCRIPTOR driver berisi penunjuk ke array struktur PCPIN_DESCRIPTOR . Jumlah elemen dalam array sama dengan jumlah pabrik pin dalam filter.

Anggota MaxGlobalInstanceCount, MaxFilterInstanceCount, dan MinFilterInstanceCount adalah jumlah maksimum dan minimum yang menjelaskan pembatasan sumber daya pin dan persyaratan fungsional. Array PCPIN_DESCRIPTOR yang diinisialisasi otomatis hanya dapat menyajikan perkiraan statis dari sumber daya pin yang tersedia. Metode IPinCount::P inCount menyediakan sarana bagi driver untuk merevisi daftar sumber daya pin yang tersedia secara dinamis karena pin dialokasikan dan dibebaskan.

Nilai MaxGlobalInstanceCount mirip dengan:

Parameter panggilan GlobalPossible metode PinCount.
Nilai properti KSPROPERTY_PIN_GLOBALCINSTANCES (anggota PossibleCount struktur KSPIN_CINSTANCES).

Nilai MaxFilterInstanceCount mirip dengan yang berarti:

Parameter panggilan FilterPossible metode PinCount.
Nilai properti KSPROPERTY_PIN_CINSTANCES (anggota PossibleCount struktur KSPIN_CINSTANCES).

Nilai MinFilterInstanceCount mirip dengan:

Parameter panggilan FilterNecessary metode PinCount.
Nilai properti KSPROPERTY_PIN_NECESSARYINSTANCES .

Saat menjelaskan pin jembatan (lihat Grafik Filter Audio), atur MaxGlobalInstanceCount, MaxFilterInstanceCount, dan MinFilterInstanceCount ke nol, dan atur AutomationTable ke NULL.

Untuk contoh kode sederhana yang menunjukkan bagaimana struktur PCPIN_DESCRIPTOR digunakan, lihat Mengekspos Topologi Filter.

Untuk informasi selengkapnya, lihat Menyematkan Pabrik.