Fungsi panggilan balik PFNKSDEVICEPNPSTART (ks.h)
Rutinitas AVStrMiniDeviceStart AVStream minidriver dipanggil saat permintaan IRP_MN_START_DEVICE dikirim untuk perangkat tertentu.
Sintaks
PFNKSDEVICEPNPSTART Pfnksdevicepnpstart;
NTSTATUS Pfnksdevicepnpstart(
[in] PKSDEVICE Device,
[in] PIRP Irp,
[in, optional] PCM_RESOURCE_LIST TranslatedResourceList,
[in, optional] PCM_RESOURCE_LIST UntranslatedResourceList
)
{...}
Parameter
[in] Device
Penunjuk ke struktur KSDEVICE yang menjelaskan perangkat yang akan dimulai.
[in] Irp
Arahkan ke IRP_MN_START_DEVICE yang diterima.
[in, optional] TranslatedResourceList
Penunjuk ke struktur CM_RESOURCE_LIST yang berisi daftar sumber daya terjemahan yang diekstrak dari Irp. Sama dengan NULL jika Perangkat tidak memiliki sumber daya yang ditetapkan. Opsional.
[in, optional] UntranslatedResourceList
Penunjuk ke struktur CM_RESOURCE_LIST yang berisi daftar sumber daya yang tidak diterjemahkan yang diekstrak dari Irp. Sama dengan NULL jika anggota KSDEVICE dari daftar parameter ini tidak memiliki sumber daya yang ditetapkan. Pilihan.
Mengembalikan nilai
Harus mengembalikan STATUS_SUCCESS atau kode kesalahan yang dikembalikan dari upaya untuk melakukan operasi. Awal dijamin berhasil jika rutin mengembalikan kode status yang berhasil. JANGAN mengembalikan STATUS_PENDING.
Keterangan
Tentukan alamat rutin ini di anggota Mulai dari struktur KSDEVICE_DISPATCH-nya .
Biasanya, rutinitas ini digunakan oleh minidriver yang harus mengevaluasi sumber daya yang ditetapkan. Daftar sumber daya diekstrak dari Irp untuk kenyamanan minidriver. Minidriver dapat mengurai daftar sumber daya untuk menemukan gangguan yang ditetapkan ke perangkat, serta alamat fisik sumber daya memori.
Minidriver dapat menggunakan rutinitas ini untuk mengalokasikan informasi konteks untuk dikaitkan dengan perangkat AVStream. (Ini mirip dengan minidriver di bawah kelas stream menggunakan ekstensi perangkat untuk menyimpan informasi konteks.)
Perhatikan bahwa STATUS_PENDING bukan kode pengembalian hukum dari fungsi ini. Untuk melakukan tindakan dalam konteks utas pekerja sebelum AVStream menyelesaikan tindakan mulai seperti mengaktifkan antarmuka perangkat, gunakan pengiriman mulai posting. Lihat AVStrMiniDevicePostStart.
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) |