다음을 통해 공유


StreamClassCallAtNewPriority 함수(strmini.h)

StreamClassCallAtNewPriority 루틴은 다른 우선 순위에서 호출되는 루틴을 예약합니다.

구문

VOID STREAMAPI StreamClassCallAtNewPriority(
  [in, optional] PHW_STREAM_OBJECT    StreamObject,
  [in]           PVOID                HwDeviceExtension,
  [in]           STREAM_PRIORITY      Priority,
  [in]           PHW_PRIORITY_ROUTINE PriorityRoutine,
  [in]           PVOID                Context
);

매개 변수

[in, optional] StreamObject

스트림을 지정하는 HW_STREAM_OBJECT 구조체에 대한 포인터는 루틴과 연결되고, 루틴이 디바이스 전체와 연결된 경우 NULL 입니다. 스트림당 하나의 루틴만 있을 수 있으며 디바이스에 대한 루틴은 하나만 있을 수 있습니다. 이 매개 변수는 선택적 요소입니다.

[in] HwDeviceExtension

미니 드라이버의 디바이스 확장에 대한 포인터입니다. minidriver는 StreamClassRegisterMinidriver를 통해 자신을 등록할 때 통과하는 HW_INITIALIZATION_DATA 구조에서 이 버퍼의 크기를 지정합니다. 그런 다음 클래스 드라이버는 미니 드라이버에 전달하는 HW_STREAM_REQUEST_BLOCK, HW_STREAM_OBJECT, HW_TIME_CONTEXTPORT_CONFIGURATION_INFORMATION 구조체의 HwDeviceExtension 멤버에 있는 버퍼에 포인터를 전달합니다.

[in] Priority

다음 표에 나열된 값 중 하나를 지정합니다.

우선 순위 사용량
높음 스트림 클래스 드라이버는 미니드라이버의 StrMiniXxx 콜백과 동일한 우선 순위로 루틴을 호출합니다. 루틴을 미니드라이버의 인터럽트 서비스 루틴과 동기화해야 하는 경우가 아니면 이 설정을 사용하지 마세요.
Dispatch 스트림 클래스 드라이버는 DISPATCH_LEVEL 루틴을 호출합니다. 루틴을 완료하는 데 1밀리초 미만이 걸리는 경우 이 우선 순위를 사용합니다.
낮음 스트림 클래스 드라이버는 PASSIVE_LEVEL 루틴을 호출합니다. 루틴을 완료하는 데 1밀리초 미만이 걸리는 경우 이 우선 순위를 사용합니다.
LowToHigh 다른 스트림 클래스 드라이버 서비스를 호출할 수 있도록 우선 순위가 낮은 스레드가 높은 우선 순위로 돌아갈 수 있도록 하는 데 사용됩니다.

[in] PriorityRoutine

지정된 우선 순위 수준에서 호출할 미니드라이버 제공 StrMiniPriorityRoutine 에 대한 포인터입니다.

[in] Context

PriorityRoutine에 전달할 매개 변수를 지정합니다.

반환 값

없음

요구 사항

요구 사항
대상 플랫폼 데스크톱
머리글 strmini.h(Strmini.h 포함)
라이브러리 Stream.lib
IRQL (매개 변수 섹션 참조)