PGET_DEVICE_INFORMATION fungsi panggilan balik (hdaudio.h)

  • Artikel

Rutinitas GetDeviceInformation mengambil informasi tentang perangkat pengontrol HD Audio.

Jenis penunjuk fungsi untuk GetDeviceInformation rutinitas didefinisikan sebagai berikut.

Sintaks

PGET_DEVICE_INFORMATION PgetDeviceInformation;

NTSTATUS PgetDeviceInformation(
  [in]      PVOID _context,
  [in, out] PHDAUDIO_DEVICE_INFORMATION DeviceInformation
)
{...}

Parameter

[in] _context

Menentukan nilai konteks dari anggota KonteksHDAUDIO_BUS_INTERFACE atau struktur HDAUDIO_BUS_INTERFACE_V2 .

[in, out] DeviceInformation

Mengambil informasi tentang perangkat pengontrol HD Audio. Parameter ini menunjuk ke struktur HDAUDIO_DEVICE_INFORMATION yang dialokasikan penelepon tempat rutin menulis informasi perangkat.

Nilai kembali

GetDeviceInformation mengembalikan STATUS_SUCCESS jika panggilan berhasil. Jika tidak, rutinitas mengembalikan kode kesalahan yang sesuai. Tabel berikut ini memperlihatkan kemungkinan kode status pengembalian.

Menampilkan kode Deskripsi
STATUS_BUFFER_TOO_SMALL
 Menunjukkan bahwa ukuran yang ditentukan di awal buffer deviceInformation terlalu kecil.

Keterangan

Rutinitas ini mengambil informasi yang bergantung pada perangkat yang statis-yaitu, informasi tidak berubah secara dinamis dari waktu ke waktu.

Parameter deviceInformation adalah penunjuk ke buffer yang berisi struktur HDAUDIO_DEVICE_INFORMATION tempat rutin menulis informasi tentang pengontrol Hd Audio. Sebelum memanggil GetDeviceInformation, penelepon mengalokasikan buffer dan menulis ukuran buffer dalam byte ke anggota Ukuran di awal buffer.

Persyaratan

Persyaratan Nilai
Target Platform Desktop
Header hdaudio.h (termasuk Hdaudio.h)
IRQL PASSIVE_LEVEL

Lihat juga

HDAUDIO_BUS_INTERFACE

HDAUDIO_BUS_INTERFACE_V2

HDAUDIO_DEVICE_INFORMATION