Функция StreamClassRegisterAdapter (strmini.h)

Статья
08/07/2023

Подпрограмма StreamClassRegisterAdapter регистрирует мини-хранилище класса потока.

Имя StreamClassRegisterAdapter поддерживается только для обеспечения обратной совместимости.

Вместо этого корпорация Майкрософт рекомендует использовать StreamClassRegisterMinidriver, псевдоним StreamClassRegisterAdapter. Более точное имя StreamClassRegisterMinidriver указывает, что подпрограмма регистрирует мини-диск класса потока. После регистрации мини-накопитель может управлять любым количеством экземпляров адаптера в системе.

Подпрограмма StreamClassRegisterMinidriver регистрирует minidriver потока в драйвере класса stream.

Синтаксис

NTSTATUS STREAMAPI StreamClassRegisterAdapter(
  [in] PVOID                   Argument1,
  [in] PVOID                   Argument2,
  [in] PHW_INITIALIZATION_DATA HwInitializationData
);

Параметры

[in] Argument1

Указывает на первый аргумент процедуры DriverEntry мини-драйвера.

[in] Argument2

Указывает на второй аргумент для подпрограммы DriverEntry мини-драйвера.

[in] HwInitializationData

Указывает на структуру HW_INITIALIZATION_DATA , которая предоставляет сведения, необходимые драйверу класса для начала инициализации мини-накопителя.

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

Возвращает STATUS_SUCCESS при успешном выполнении или соответствующий код ошибки при сбое.

Argument1 Предоставляет контекстное значение, с помощью которого мини-driver адаптера должен вызывать StreamClassRegisterMinidriver. Для Windows 2000 и более поздних версий это указывает на DRIVER_OBJECT.

Argument2 Предоставляет второе контекстное значение, с помощью которого мини-накопитель адаптера должен вызывать StreamClassRegisterMinidriver. Для Windows 2000 и более поздних версий это указывает на путь к реестру.

DriverEntry возвращает значение, возвращаемое вызовом StreamClassRegisterMinidriver.

Примечания DriverEntry — это начальная точка входа для мини-драйвера класса потока.

Так как StreamClassRegisterMinidriver выполняет большую часть требуемой инициализации драйвера, основной задачей подпрограммы DriverEntry класса потока является выделение и заполнение структуры HW_INITIALIZATION_DATA константами драйвера и точками входа. Затем DriverEntry должен вызвать StreamClassRegisterMinidriver.

Большая часть информации, передаваемой в структуре HW_INITIALIZATION_DATA, сообщает драйверу класса о обратных вызовах на уровне мини-накопителя и о том, какой размер буфера следует выделить для структур данных мини-накопителя. Драйвер класса запрашивает у мини-драйвера дополнительные сведения о запуске через SRB_INITIALIZE_DEVICE и SRB_GET_STREAM_INFO запросы к подпрограмме StrMiniReceiveDevicePacket мини-диска (передается как член HwReceivePacket HW_INITIALIZATION_DATA).

После регистрации мини-накопитель может управлять любым количеством экземпляров адаптера в системе.