Fungsi panggilan balik PFNKSPINITIALIZEALLOCATOR (ks.h)
Rutinitas AVStrMiniInitializeAllocator AVStream minidriver menginisialisasi alokator yang akan dikaitkan dengan pin.
Sintaks
PFNKSPININITIALIZEALLOCATOR Pfnkspininitializeallocator;
NTSTATUS Pfnkspininitializeallocator(
[in] PKSPIN Pin,
[in] PKSALLOCATOR_FRAMING AllocatorFraming,
[out] PVOID *Context
)
{...}
Parameter
[in] Pin
Penunjuk ke struktur KSPIN yang menjelaskan pin yang akan dikaitkan dengan alokator.
[in] AllocatorFraming
Penunjuk ke struktur KSALLOCATOR_FRAMING yang menjelaskan persyaratan pembingkaian yang harus digunakan alokator.
[out] Context
Arahkan ke konteks untuk alokator yang akan diteruskan sebagai parameter ke rutinitas lain untuk struktur ini. Misalnya, driver dapat menyimpan struktur pembingkaian pin atau alokator untuk referensi nanti oleh rutinitas panggilan balik lainnya. Perhatikan bahwa rutinitas lain untuk KSALLOCATOR_DISPATCH harus memiliki setidaknya cara tidak langsung untuk mereferensikan Pin. (Misalnya, AVStrMiniAllocate harus dapat mengakses informasi AllocatorFraming untuk Pin, dan Konteks adalah satu-satunya parameter yang akan diteruskan AVStream.)
Nilai kembali
AVStrMiniInitializeAllocator harus mengembalikan STATUS_SUCCESS atau kode kesalahan yang diterimanya mencoba membuat alokator.
Keterangan
Minidriver menentukan alamat rutin ini di anggota InitializeAllocator dari struktur KSALLOCATOR_DISPATCH-nya . Minidriver meneruskan struktur ini ke driver kelas di KSPIN_DISPATCH.
Perhatikan bahwa alokator mode kernel tidak dapat mengalokasikan bingkai yang akhirnya dapat mencapai mode pengguna.
AVStream memanggil AVStrMiniInitializeAllocator untuk menginisialisasi alokator yang diberikan. Handler untuk rutinitas ini harus bersiap untuk menangani alokasi memori dan permintaan gratis.
Untuk informasi selengkapnya, lihat Alokator KS.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Klien minimum yang didukung | Tersedia di Microsoft Windows XP dan sistem operasi yang lebih baru serta DirectX 8.0 dan versi DirectX yang lebih baru. |
| Target Platform | Desktop |
| Header | ks.h (termasuk Ks.h) |