StreamClassRegisterAdapter 함수(strmini.h)

아티클
02/29/2024

StreamClassRegisterAdapter 루틴은 스트림 클래스 미니 드라이버를 등록합니다.

StreamClassRegisterAdapter라는 이름은 이전 버전과의 호환성에서만 지원됩니다.

대신 StreamClassRegisterAdapter의 별칭인 StreamClassRegisterMinidriver를 사용하는 것이 좋습니다. StreamClassRegisterMinidriver라는 이름은 루틴이 스트림 클래스 미니 드라이버를 등록한다는 것을 보다 정확하게 나타냅니다. 등록되면 미니드라이버가 시스템의 어댑터 인스턴스 수를 지정할 수 있습니다.

StreamClassRegisterMinidriver 루틴은 스트림 클래스 드라이버에 스트림 미니 드라이버를 등록합니다.

구문

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 반환하거나 실패 시 적절한 오류 코드를 반환합니다.

설명

스트림 미니드라이버가 DriverEntry 루틴 내에서 StreamClassRegisterMinidriver를 호출해야 합니다.

스트림 미니드라이버의 DriverEntry 는 스트림 클래스 미니드라이버를 초기화합니다. 이 루틴은 필수입니다.

Argument1 어댑터 미니드라이버가 StreamClassRegisterMinidriver를 호출해야 하는 컨텍스트 값을 제공합니다. Windows 2000 이상에서는 DRIVER_OBJECT 가리킵니다.

Argument2 어댑터 미니드라이버가 StreamClassRegisterMinidriver를 호출해야 하는 두 번째 컨텍스트 값을 제공합니다. Windows 2000 이상의 경우 레지스트리 경로를 가리킵니다.

DriverEntry 는 StreamClassRegisterMinidriver 호출에서 반환된 값을 반환합니다.

주의 DriverEntry 는 스트림 클래스 미니 드라이버의 초기 진입점입니다.

StreamClassRegisterMinidriver는 대부분의 필수 드라이버 초기화를 수행하기 때문에 스트림 클래스 미니 드라이버의 DriverEntry 루틴의 기본 작업은 드라이버별 상수 및 진입점으로 HW_INITIALIZATION_DATA 구조를 할당하고 채우는 것입니다. 그런 다음 DriverEntry는 StreamClassRegisterMinidriver를 호출해야 합니다.

HW_INITIALIZATION_DATA 구조에 전달된 대부분의 정보는 클래스 드라이버에 미니드라이버 전체 콜백과 미니드라이버의 데이터 구조에 할당할 크기 버퍼를 알려줍니다. 클래스 드라이버는 미니 드라이버의 StrMiniReceiveDevicePacket 루틴(HW_INITIALIZATION_DATAHwReceivePacket 멤버로 전달됨)에 대한 SRB_INITIALIZE_DEVICE 및 SRB_GET_STREAM_INFO 요청을 통해 미니 드라이버에 추가 시작 정보를 쿼리합니다.

등록되면 미니드라이버가 시스템의 어댑터 인스턴스 수를 지정할 수 있습니다.