Fungsi panggilan balik PFNKSDEVICECREATE (ks.h)
Rutinitas AVStrMiniDeviceAdd minidriver AVStream memberi tahu minidriver bahwa rutinitas AddDevice PnP AVStream telah selesai.
Sintaks
PFNKSDEVICECREATE Pfnksdevicecreate;
NTSTATUS Pfnksdevicecreate(
[in] PKSDEVICE Device
)
{...}
Parameter
[in] Device
Penunjuk ke struktur KSDEVICE yang menjelaskan objek perangkat fungsi (FDO) yang baru saja dibuat.
Nilai kembali
Harus mengembalikan STATUS_SUCCESS atau kode kesalahan yang dikembalikan dari upaya untuk melakukan operasi. Jika minidriver mengembalikan status kegagalan, panggilan AddDevice terkait juga akan gagal. Lihat bagian Keterangan di bawah ini untuk detail selengkapnya.
Keterangan
Minidriver menentukan alamat rutin ini di tambahkan anggota struktur KSDEVICE_DISPATCH- nya .
AVStream memanggil AVStrMiniDeviceAdd dari rutinitas AddDevice defaultnya, pada waktu inisialisasi KSDEVICE . Pada titik di mana rutinitas ini dipanggil, objek perangkat WDM (DEVICE_OBJECT) telah dibuat, struktur KSDEVICE telah dibuat dan diinisialisasi, dan header perangkat KS telah dialokasikan.
Minidriver dapat menggunakan rutinitas ini untuk mengaitkan informasi konteks dengan objek perangkat AVStream, atau untuk menginisialisasi ekstensi perangkat.
Jika rutinitas ini mengembalikan kode status yang gagal, rutinitas AddDevice AVStream akan gagal. STATUS_PENDING bukan kode pengembalian hukum karena tidak ada IRP yang terlibat. Rutinitas dipanggil di IRQL = PASSIVE_LEVEL saja.
Rutinitas ini bersifat opsional.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Klien minimum yang didukung | Tersedia di Microsoft Windows XP dan sistem operasi yang lebih baru dan DirectX 8.0 dan versi DirectX yang lebih baru. |
| Target Platform | Desktop |
| Header | ks.h (termasuk Ks.h) |
| IRQL | PASSIVE_LEVEL (Lihat bagian Keterangan) |