Fungsi AtaPortRegistryAllocateBuffer (irb.h)

Artikel
03/01/2024

Rutinitas AtaPortRegistryAllocateBuffer mengalokasikan buffer untuk operasi registri.

Catatan Driver port ATA dan model driver miniport ATA dapat diubah atau tidak tersedia di masa depan. Sebagai gantinya, sebaiknya gunakan driver Storport dan model driver miniport Storport .

Sintaks

PVOID AtaPortRegistryAllocateBuffer(
  [in] PVOID ChannelExtension,
       ULONG BufferSize
);

Parameter

[in] ChannelExtension

Penunjuk ke ekstensi saluran.

BufferSize

Menentukan panjang buffer, dalam byte.

Nilai kembali

AtaPortRegistryAllocateBuffer mengembalikan penunjuk ke buffer yang dialokasikan saat berhasil. Jika tidak, ia mengembalikan NULL.

Keterangan

Driver port memungkinkan driver miniport mengalokasikan satu buffer untuk semua operasi registrinya. Setelah driver miniport mengalokasikan buffer dengan AtaPortRegistryAllocateBuffer, panggilan ke AtaPortRegistryAllocateBuffer akan gagal dan mengembalikan NULL. Setelah driver miniport membebaskan buffer yang dialokasikan dengan panggilan ke rutinitas AtaPortRegistryFreeBuffer , ia dapat kembali mengalokasikan buffer dengan memanggil AtaPortRegistryAllocateBuffer.

Driver miniport harus memanggil AtaPortRegistryAllocateBuffer baik dalam rutinitas AtaChannelInitRoutine atau dalam rutinitas IdeHwControl-nya . Ini tidak dapat memanggil AtaPortRegistryAllocateBuffer dari rutinitas lainnya. Selain itu, driver miniport hanya dapat memanggil AtaPortRegistryAllocateBuffer dari rutinitas IdeHwControl-nya jika rutinitas IdeHwControl-nya dipanggil dan memiliki nilai StartChannel atau StopChannel dalam parameter ControlAction-nya .

Persyaratan

Persyaratan	Nilai
Target Platform	Desktop
Header	irb.h (termasuk Ata.h, Irb.h)
Pustaka	Ataport.lib; Pciidex.lib

Lihat juga

AtaChannelInitRoutine

AtaPortRegistryFreeBuffer

IdeHwControl

Bagikan melalui