IMiniportMidiStream::Metode baca (portcls.h)

  • Artikel

Metode ini Read membaca data dari aliran MIDI masuk.

Sintaks

NTSTATUS Read(
  [in]  PVOID  BufferAddress,
  [in]  ULONG  BufferLength,
  [out] PULONG BytesRead
);

Parameter

[in] BufferAddress

Menentukan alamat buffer yang dialokasikan penelepon. Metode menyalin data MIDI masuk dari perangkat ke buffer. Ukuran buffer ini yang dialokasikan harus lebih besar dari atau sama dengan BufferLength.

[in] BufferLength

Menentukan panjang dalam byte buffer yang diacu oleh BufferAddress.

[out] BytesRead

Penunjuk output ke variabel yang dialokasikan penelepon tempat metode menulis hitungan yang menentukan jumlah byte aktual yang berhasil dibaca dari perangkat ke dalam buffer.

Nilai kembali

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

Menampilkan kode Deskripsi
STATUS_INVALID_DEVICE_REQUEST
 Permintaan perangkat tidak valid (misalnya, memanggil Read aliran output MIDI).

Keterangan

Driver miniport memanggil IPortMidi::Notify untuk memberi tahu driver port ketika data MIDI masuk tersedia dari perangkat pengambilan. Driver port memanggil IMiniportMidi::Read untuk mengambil data. Driver port terus memanggil Read selama lebih banyak data tersedia.

Metode mengembalikan Read STATUS_SUCCESS dan jumlah BytesRead nol untuk menunjukkan bahwa tidak ada lagi data input MIDI yang saat ini tersedia dari perangkat.

Persyaratan

Persyaratan Nilai
Target Platform Universal
Header portcls.h (termasuk Portcls.h)
IRQL DISPATCH_LEVEL

Lihat juga

IMiniportMidiStream

IMiniportMidiStream::Write

IPortMidi::Beri tahu