Метод IMiniport::D ataRangeIntersection (portcls.h)

Статья
08/07/2023

Метод DataRangeIntersection определяет пересечение двух диапазонов данных с наивысшим качеством.

Синтаксис

NTSTATUS DataRangeIntersection(
  ULONG        PinId,
  PKSDATARANGE DataRange,
  PKSDATARANGE MatchingDataRange,
  ULONG        OutputBufferLength,
  PVOID        ResultantFormat,
  PULONG       ResultantFormatLength
);

Параметры

PinId

Указывает идентификатор пин-кода. Этот параметр определяет фабрику контактов, для которой определяется пересечение данных. Если фильтр содержит n фабрик контактов, допустимые идентификаторы контактов варьируются от 0 до n-1.

DataRange

Указатель на структуру KSDATARANGE, содержащую диапазон данных, отправленный клиентом в запросе на пересечение свойства диапазона данных.

MatchingDataRange

Указатель на структуру KSDATARANGE, содержащую диапазон данных драйвера мини-порта, который должен сравниваться с диапазоном данных клиента.

OutputBufferLength

Задает размер буфера в байтах, на который указывает параметр ResultantFormat. Вызывающий объект может указать OutputBufferLength в качестве нуля, чтобы запросить требуемый размер буфера. Дополнительные сведения см. в разделе "Примечания".

ResultantFormat

Указатель на буфер, в который метод записывает результирующий формат. Если этот параметр имеет значение NULL, параметр OutputBufferLength должен быть равен нулю. Если значение не равно NULL, этот параметр должен указывать на буфер, который достаточно велик, чтобы содержать число байтов, указанное в OutputBufferLength.

ResultantFormatLength

Указатель вывода для результирующий длины формата. Этот параметр указывает на выделенную вызывающим объектом переменную ULONG, в которую метод записывает длину результирующих форматов. Это размер в байтах результирующий формат, который записывается в буфер, на который указывает ResultantFormat. Этот размер должен быть меньше или равен OutputBufferLength (если только OutputBufferLength не равен нулю; см. следующий раздел Примечания).

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

Этот метод возвращает NTSTATUS, который содержит STATUS_SUCCESS, был ли вызов успешным. Если параметр OutputBufferLength был указан как ноль, метод возвращает STATUS_BUFFER_OVERFLOW. В противном случае метод возвращает соответствующий код ошибки. В следующей таблице показаны некоторые возможные коды состояния возврата.

Код возврата	Описание
STATUS_NO_MATCH	Пересечения нет.
STATUS_NOT_IMPLEMENTED	Откладывает обработку пересечения данных на обработчик пересечения данных драйвера порта по умолчанию.
STATUS_BUFFER_TOO_SMALL	Длина буфера, указанная в OutputBufferLength, была ненулевой, но слишком мала для хранения результирующих форматов.

Метод DataRangeIntersection — это обработчик пересечения данных драйвера miniport. Драйвер порта вызывает этот метод, когда получает запрос на пересечение свойства диапазона данных (см. KSPROPERTY_PIN_DATAINTERSECTION), а целевым объектом для запроса является фабрика контактов на экземпляре фильтра, реализуемом драйвером мини-порта.

Параметр ResultantFormat указывает на буфер, который начинается со структуры KSDATAFORMAT_WAVEFORMATEX. Обратите внимание, что элемент WaveFormatEx этой структуры можно расширить для включения дополнительных сведений о формате (например, маски конфигурации канала). Дополнительные сведения см. в разделе WAVEFORMATEXTENSIBLE.

Параметр ResultantFormat является необязательным и может быть указан как NULL, в этом случае OutputBufferLength должен быть указан как нуль. Вызывающий объект может запросить требуемую длину буфера, выполнив первоначальный вызов DataRangeIntersection со значением OutputBufferLength, равным нулю. В ответ метод записывает необходимую длину буфера в расположение, на которое указывает ResultantFormatLength, и возвращает код состояния STATUS_BUFFER_OVERFLOW. Затем вызывающий объект может выделить буфер требуемого размера и указать этот буфер во втором вызове DataRangeIntersection.

Если драйвер поддерживает KSPROPERTY_AUDIOSIGNALPROCESSING_MODES, этот метод должен возвращать ResultantFormat , если формат поддерживается любым режимом обработки звукового сигнала.

Требования

Требование	Значение
Заголовок	portcls.h
IRQL	PASSIVE_LEVEL

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

IMiniPort