Функция обратного вызова PFNKSPINSETDATAFORMAT (ks.h)

Статья
08/07/2023

Подпрограмма AVStrMiniPinSetDataFormat мини-драйвера AVStream вызывается во время создания контакта, чтобы убедиться, что ранее согласованный формат данных является приемлемым для этой структуры KSPIN и соответствует этой структуре KSDATARANGE . Эта подпрограмма также называется из-за определенных типов динамических изменений формата, например принятия запроса KSPROPERTY_CONNECTION_PROPOSEDATAFORMAT свойства.

Синтаксис

PFNKSPINSETDATAFORMAT Pfnkspinsetdataformat;

NTSTATUS Pfnkspinsetdataformat(
  [in]           PKSPIN Pin,
  [in, optional] PKSDATAFORMAT OldFormat,
  [in, optional] PKSMULTIPLE_ITEM OldAttributeList,
  [in]           const KSDATARANGE *DataRange,
  [in, optional] const KSATTRIBUTE_LIST *AttributeRange
)
{...}

Параметры

[in] Pin

Указатель на структуру KSPIN , для которой изменяется формат данных.

[in, optional] OldFormat

Необязательный элемент. Указатель на структуру KSDATAFORMAT . Мини-накопители могут использовать это поле для определения формата данных, который использовался контактом до этого вызова. Значение NULL указывает, что для пин-кода не задан формат данных и что диспетчеризация создания пин-кода еще не выполнена . Значение NULL здесь указывает, что эта подпрограмма была вызвана во время инициализации для проверки формата.

[in, optional] OldAttributeList

Необязательный элемент. Указатель на структуру KSMULTIPLE_ITEM , в котором хранятся атрибуты для предыдущего формата.

[in] DataRange

Указатель на структуру KSDATARANGE . Диапазон данных для нового формата.

[in, optional] AttributeRange

Необязательный элемент. Диапазон атрибутов для нового формата.

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

Возвращает STATUS_SUCCESS, если элемент ConnectionFormatpin соответствует диапазону, переданного в эту подпрограмму. Верните STATUS_NO_MATCH, если ConnectionFormat не соответствует заданному диапазону и мини-диск будет продолжать пытаться найти совпадение с другим диапазоном. Возвращает код ошибки, если ConnectionFormat не соответствует переданного диапазона и мини-диск не хочет продолжать пытаться найти совпадение с другим диапазоном. Не возвращайте STATUS_PENDING.

В круге 3 модуль прокси-сервера потоковой передачи ядра (KsProxy) задает формат данных на основе согласованного формата подключения или динамического изменения формата. KsProxy выдает запрос KSPROPERTY_CONNECTION_DATAFORMAT , который после некоторой первоначальной проверки преобразуется в этот вызов диспетчера к мини-driver. См . раздел Прокси-сервер потоковой передачи ядра. Дополнительные сведения см. в разделах Форматы данных KS и диапазоны данных и Пересечения dataRange в AVStream.

Мини-driver указывает адрес avStrMiniPinSetDataFormat в элементе SetDataFormatструктуры KSPIN_DISPATCH .

Эту процедуру можно вызвать до того, как пин-код получит IRP_MJ_CREATE, и мини-накопители должны быть готовы к решению этой ситуации.

OldFormat, OldAttributeList и AttributeRange являются необязательными параметрами и могут иметь значение NULL.

Эта подпрограмма является необязательной.

Требования

Требование	Значение
Минимальная версия клиента	Доступно в операционных системах Microsoft Windows XP и более поздних версиях, а также DirectX 8.0 и более поздних версий.
Целевая платформа	Персональный компьютер
Верхняя часть	ks.h (включая Ks.h)
IRQL	PASSIVE_LEVEL

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

Share via