Metode IPortClsNotifications::AllocNotificationBuffer (portcls.h)

Mengalokasikan buffer dengan ukuran yang ditentukan, dalam kumpulan memori yang ditentukan, untuk digunakan dalam mengirim pemberitahuan, untuk memungkinkan komunikasi antara modul audio dan aplikasi UWP.

Untuk informasi selengkapnya tentang modul audio, lihat Menerapkan Penemuan Modul Audio.

Sintaks

NTSTATUS AllocNotificationBuffer(
  [in]  POOL_TYPE              PoolType,
  [in]  USHORT                 NumberOfBytes,
  [out] PPCNOTIFICATION_BUFFER *NotificationBuffer
);

Parameter

[in] PoolType

Menentukan jenis kumpulan memori tempat objek dialokasikan (lihat POOL_TYPE). Nilai yang disarankan adalah NonPagedPoolNx atau PagedPool. Pemilihan jenis kumpulan memori juga tergantung pada tingkat IRQL. Jika berjalan pada DISPATCH_LEVEL memori harus non-halaman.

[in] NumberOfBytes

Jumlah byte yang akan dialokasikan.

[out] NotificationBuffer

Arahkan ke PCNOTIFICATION_BUFFER metode yang menulis alamat pemberitahuan yang dialokasikan.

Nilai kembali

STATUS_SUCCESS – Driver dapat mengalokasikan buffer pemberitahuan.

STATUS_INVALID_PARAMETER – Driver mengembalikan kesalahan ini jika menemukan parameter lain yang tidak valid, selain dari kasus tertentu untuk instans status kesalahan lainnya.

Kode status standar tambahan dapat dikembalikan. Misalnya, STATUS_INSUFFICIENT_RESOURCES akan dikembalikan jika tidak memungkinkan untuk mengalokasikan buffer yang diperlukan.

Keterangan

Penelepon AllocNotificationBuffer harus berjalan di IRQL <= DISPATCH_LEVEL. Jika penulis driver memanggil rutinitas ini di IRQL = DISPATCH_LEVEL, NotificationStructure harus dialokasikan dari memori yang tidak di-patahkan.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Tersedia di windows versi Windows 10, versi 1703, dan yang lebih baru.
Target Platform	Universal
Header	portcls.h (termasuk Portcls.h)
Pustaka	Portcls.lib
IRQL	<= DISPATCH_LEVEL (lihat bagian Keterangan)

Lihat juga

IPortClsNotifications