Metode IKsDeviceFunctions::RegisterAdapterObjectEx (ks.h)
Metode IKsDeviceFunctions::RegisterAdapterObjectEx mendaftarkan objek adaptor DMA dengan AVStream. Semua driver yang dikompilasi untuk platform Win64 harus menggunakan metode ini alih-alih KsDeviceRegisterAdapterObject.
Sintaks
NTSTATUS RegisterAdapterObjectEx(
[in] PADAPTER_OBJECT AdapterObject,
[in] PDEVICE_DESCRIPTION DeviceDescription,
[in] ULONG NumberOfMapRegisters,
[in] ULONG MaxMappingsByteCount,
[in] ULONG MappingTableStride
);
Parameter
[in] AdapterObject
Arahkan ke ADAPTER_OBJECT untuk perangkat. Harus diperoleh melalui IoGetDmaAdapter sebelum memanggil RegisterAdapterObjectEx.
[in] DeviceDescription
Arahkan ke struktur jenis DEVICE_DESCRIPTION yang menjelaskan atribut perangkat fisik tempat pemanggil mendaftarkan objek DMA.
[in] NumberOfMapRegisters
Menentukan jumlah register peta yang dikembalikan dari panggilan minidriver ke IoGetDmaAdapter.
[in] MaxMappingsByteCount
Menentukan jumlah maksimum byte yang dapat ditangani perangkat untuk satu pemetaan. Memungkinkan AVStream untuk secara otomatis memecah potongan besar memori fisik yang berdekatan menjadi beberapa elemen sebar/kumpulkan untuk perangkat yang memberlakukan batas ukuran pada pemetaan individual dalam transfer DMA. Lihat informasi tambahan penting tentang MaxMappingsByteCount di halaman referensi KsDeviceRegisterAdapterObject .
[in] MappingTableStride
Menentukan berapa banyak byte yang diperlukan setiap entri dalam tabel pemetaan. Nilai ini harus setidaknya ukuranof (KSMAPPING) dan bisa sebesar yang diperlukan.
Ruang tambahan dapat digunakan oleh minidriver sebagai informasi konteks.
Nilai kembali
RegisterAdapterObjectEx mengembalikan STATUS_SUCCESS jika objek DMA berhasil didaftarkan. Metode mengembalikan STATUS_INSUFFICIENT_RESOURCES jika memori yang cukup tidak tersedia.
Keterangan
Lihat juga Mendukung DMA di Driver AVStream 64-Bit.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Klien minimum yang didukung | Tersedia di Microsoft Windows Server 2003 dengan Paket Layanan 1 (SP1) dan versi Windows yang lebih baru. |
| Target Platform | Universal |
| Header | ks.h (termasuk Ks.h) |