IOCTL_SBAUD_GET_ENDPOINT_DESCRIPTOR IOCTL (sidebandaudio.h)

Driver audio mengeluarkan kode kontrol IOCTL_SBAUD_GET_ENDPOINT_DESCRIPTOR untuk mendapatkan informasi tentang titik akhir Audio yang diekspos melalui antarmuka perangkat audio sideband.

Kode utama

IRP_MJ_DEVICE_CONTROL

Buffer input

Nilai indeks titik akhir berbasis 0 berdasarkan jumlah titik akhir Audio seperti yang dilaporkan oleh IOCTL_SBAUD_GET_DEVICE_DESCRIPTOR.

Ini adalah nilai ULONG dari 0 hingga (N-1) di mana N adalah jumlah Titik Akhir untuk perangkat.

Panjang buffer input

Ukuran ULONG.

Buffer output

Buffer yang berisi struktur SIDEBANDAUDIO_ENDPOINT_DESCRIPTOR diikuti oleh data lain yang direferensikan oleh struktur. Ini dikembalikan, jika ukuran buffer output cukup dan permintaan berhasil. Secara khusus, buffer menyertakan penyimpanan untuk string yang dirujuk oleh bidang FriendlyName dari struktur SIDEBANDAUDIO_ENDPOINT_DESCRIPTOR .

Panjang buffer output

Ukuran struktur SIDEBANDAUDIO_ENDPOINT_DESCRIPTOR dan data yang dirujuk.

Blok status

Jika rutinitas berhasil, maka Status diatur ke STATUS_SUCCESS dan anggota Informasi adalah jumlah byte yang ditulis rutin ke buffer output.

Catatan Ini bisa lebih besar dari ukuran struktur SIDEBANDAUDIO_ENDPOINT_DESCRIPTOR , karena buffer output mungkin berisi data lain yang dirujuk oleh struktur

Jika Status diatur ke STATUS_BUFFER_TOO_SMALL, maka driver audio harus membaca anggota Informasi untuk mendapatkan ukuran buffer yang harus dialokasikan pemanggil untuk permintaan ini.

Keterangan

IOCTL ini hanya dapat dipanggil dari mode kernel.

Driver audio mengirimkan permintaan ini untuk mendapatkan informasi tentang titik akhir sideband audio yang diaktifkan. Informasi tidak berubah saat antarmuka diaktifkan, tetapi dapat berubah saat antarmuka dinonaktifkan. Oleh karena itu driver audio mengirimkan permintaan ini tak lama setelah menemukan antarmuka perangkat yang diaktifkan dan menggunakan informasi untuk membangun struktur KSFILTER_DESCRIPTOR yang sesuai.

Driver audio mengirimkan permintaan ini sekali dengan ukuran buffer output nol (0) untuk menentukan ukuran buffer output yang diperlukan. Dalam hal ini, permintaan akan selesai dengan Status STATUS_BUFFER_TOO_SMALL dan mengatur anggota Informasi ke ukuran buffer yang diperlukan. Driver audio kemudian mengalokasikan ruang penyimpanan yang diperlukan dan mengirim permintaan lagi.

Persyaratan

Persyaratan	Nilai
Header	sidebandaudio.h

Lihat juga

SIDEBANDAUDIO_ENDPOINT_DESCRIPTOR

Pengantar Kode Kontrol I/O

sidebandaudio.h