Метод IKsDeviceFunctions::RegisterAdapterObjectEx (ks.h)
Метод IKsDeviceFunctions::RegisterAdapterObjectEx регистрирует объект адаптера DMA в AVStream. Все драйверы, скомпилированные для платформ Win64, должны использовать этот метод вместо KsDeviceRegisterAdapterObject.
Синтаксис
NTSTATUS RegisterAdapterObjectEx(
[in] PADAPTER_OBJECT AdapterObject,
[in] PDEVICE_DESCRIPTION DeviceDescription,
[in] ULONG NumberOfMapRegisters,
[in] ULONG MaxMappingsByteCount,
[in] ULONG MappingTableStride
);
Параметры
[in] AdapterObject
Указатель на ADAPTER_OBJECT устройства. Необходимо получить через IoGetDmaAdapter перед вызовомRegisterAdapterObjectEx.
[in] DeviceDescription
Указатель на структуру типа DEVICE_DESCRIPTION , описывающую атрибуты физического устройства, для которого вызывающий объект регистрирует объект DMA.
[in] NumberOfMapRegisters
Указывает количество регистров карты, возвращенных вызовом мини-драйвера к IoGetDmaAdapter.
[in] MaxMappingsByteCount
Указывает максимальное количество байтов, которое устройство может обработать для одного сопоставления. Позволяет AVStream автоматически разбить большие фрагменты непрерывной физической памяти на несколько элементов точечных и сборных данных для устройств, которые накладывают ограничение на размер отдельных сопоставлений при передаче DMA. Дополнительные сведения о MaxMappingsByteCount см. на странице справочника по KsDeviceRegisterAdapterObject .
[in] MappingTableStride
Указывает, сколько байтов требуется для каждой записи в таблице сопоставления. Это значение должно быть по крайней мере sizeof (KSMAPPING) и может быть таким же, как это необходимо.
Дополнительное пространство может использоваться мини-накопителем в качестве сведений о контексте.
Возвращаемое значение
RegisterAdapterObjectEx возвращает STATUS_SUCCESS, если объект DMA был успешно зарегистрирован. Метод возвращает STATUS_INSUFFICIENT_RESOURCES, если недостаточно памяти.
Комментарии
См. также раздел Поддержка DMA в 64-разрядных драйверах AVStream.
Требования
Требование | Значение |
---|---|
Минимальная версия клиента | Доступно в Microsoft Windows Server 2003 с пакетом обновления 1 (SP1) и более поздних версиях Windows. |
Целевая платформа | Универсальное |
Верхняя часть | ks.h (включая Ks.h) |