Struktur KSTOPOLOGY (ks.h)
Struktur KSTOPOLOGY menjelaskan topologi pin dan simpul.
Sintaksis
typedef struct {
ULONG CategoriesCount;
const GUID *Categories;
ULONG TopologyNodesCount;
const GUID *TopologyNodes;
ULONG TopologyConnectionsCount;
const KSTOPOLOGY_CONNECTION *TopologyConnections;
const GUID *TopologyNodesNames;
ULONG Reserved;
} KSTOPOLOGY, *PKSTOPOLOGY;
Anggota
CategoriesCount
Menentukan jumlah kategori fungsi yang didukung driver.
Categories
Menunjuk ke awal array kategori fungsi yang didukung driver.
TopologyNodesCount
Menentukan jumlah simpul yang didukung driver.
TopologyNodes
Menunjuk ke awal array GUID yang menjelaskan jenis setiap simpul. Untuk daftar simpul terkait streaming kernel video, lihat Node Topologi Streaming Kernel. Untuk daftar simpul terkait streaming kernel audio, lihat Node Topologi Audio.
TopologyConnectionsCount
Menentukan jumlah entri dalam array yang diarahkan oleh TopologyConnections. Nomor simpul dari setiap entri harus sesuai dengan offset array simpul dalam TopologyNodes. Ketika struktur ini adalah bagian dari HW_STREAM_HEADERstreaming minidriver , nomor pin harus sesuai dengan offset dalam array struktur HW_STREAM_INFORMATION dalam struktur HW_STREAM_DESCRIPTOR minidriver.
TopologyConnections
Menunjuk ke awal array koneksi topologi untuk struktur ini.
TopologyNodesNames
Menentukan GUID nama string Unicode yang dilokalkan untuk simpul, yang disimpan dalam registri.
Reserved
Dicadangkan untuk penggunaan sistem. Driver harus mengatur ini ke nol.
Komentar
Minidriver kelas aliran membuat dan meneruskan struktur ini sebagai bagian dari struktur HW_STREAM_HEADER. Driver kelas menggunakan struktur ini untuk memproses permintaan properti topologi. Data properti yang dikembalikan driver kelas ditentukan dari struktur KSTOPOLOGY sebagai berikut:
Persyaratan
| Syarat | Nilai |
|---|---|
| Header | ks.h (termasuk Ks.h) |