Метод 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

Указывает количество регистров карты, возвращаемых вызовом мини-driver к IoGetDmaAdapter.

[in] MaxMappingsByteCount

Указывает максимальное количество байтов, которые устройство может обрабатывать для одного сопоставления. Позволяет AVStream автоматически разбить большие блоки непрерывной физической памяти на несколько элементов точечной или сборной для устройств, которые накладывают ограничение размера на отдельные сопоставления при передаче DMA. Дополнительные сведения о MaxMappingsByteCount см. на справочной странице KsDeviceRegisterAdapterObject.

[in] MappingTableStride

Указывает, сколько байтов требуется каждая запись в таблице сопоставления. Это значение должно быть по крайней мере размера (KSMAPPING) и может быть максимально большим.

Дополнительное пространство можно использовать мини-driver в качестве сведений о контексте.

Возвращаемое значение

RegisterAdapterObjectEx возвращает STATUS_SUCCESS, если объект DMA успешно зарегистрирован. Метод возвращает STATUS_INSUFFICIENT_RESOURCES, если недостаточно памяти.

Замечания

См. также поддержка DMA в 64-разрядных драйверах AVStream.

Требования

См. также

KsDeviceRegisterAdapterObject