Метод IKsDeviceFunctions::RegisterAdapterObjectEx (ks.h)

Статья
08/07/2023

Метод 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, если недостаточно памяти.

Требования

Требование	Значение
Минимальная версия клиента	Доступно в Microsoft Windows Server 2003 с пакетом обновления 1 (SP1) и более поздних версиях Windows.
Целевая платформа	Универсальное
Верхняя часть	ks.h (включая Ks.h)

См. также раздел

KsDeviceRegisterAdapterObject

Share via