Функция StreamClassRegisterAdapter (strmini.h)
Подпрограмма 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 при успешном выполнении или соответствующий код ошибки при сбое.
Комментарии
Потоковый мини-driver должен вызывать StreamClassRegisterMinidriver в своей подпрограмме DriverEntry .
Свойство DriverEntry для stream minidriver инициализирует мини-диск класса потока. Эта подпрограмма является обязательной.
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).
После регистрации мини-накопитель может управлять любым количеством экземпляров адаптера в системе.
Требования
Требование | Значение |
---|---|
Целевая платформа | Персональный компьютер |
Верхняя часть | strmini.h (включая Strmini.h) |