PcRemoveStreamResource 함수(portcls.h)

  • 아티클

PcRemoveStreamResource는 기존 스트림 리소스를 제거합니다. PcRemoveStreamResource는 오디오 스트림과 연결된 인터럽트/스레드가 있는 비 오디오 WaveRT 미니포트 드라이버를 비롯한 모든 드라이버에서 호출할 수 있습니다. 오디오 WaveRT 미니포트 드라이버에서도 호출할 수 있습니다.

구문

PORTCLASSAPI NTSTATUS PcRemoveStreamResource(
  [in] PCSTREAMRESOURCE ResourceHandle
);

매개 변수

[in] ResourceHandle

PCSTREAMRESOURCE – PcAddStreamResource에서 반환된 리소스 핸들입니다.
자세한 내용은 PcAddStreamResource 및 PCSTREAMRESOURCE_DESCRIPTOR 참조하세요.

반환 값

STATUS_SUCCESS – 드라이버가 지정된 PDO의 리소스를 등록할 수 있었습니다.

STATUS_INVALID_PARAMETER – 드라이버가 다른 오류 상태 인스턴스에 대한 특정 사례 외에 다른 매개 변수가 유효하지 않은 것으로 확인되면 이 오류를 반환합니다.

추가 표준 상태 코드가 반환될 수 있습니다.

설명

결함이 없는 작업을 보장하려면 오디오 드라이버가 스트리밍 리소스를 portcls에 등록해야 합니다. 이를 통해 OS는 오디오 스트리밍과 다른 하위 시스템 간의 간섭을 방지하기 위해 리소스를 관리할 수 있습니다.

Stream 리소스는 오디오 드라이버가 오디오 스트림을 처리하거나 오디오 데이터 흐름을 보장하는 데 사용하는 모든 리소스입니다.

오디오 드라이버는 이전에 등록된 리소스를 제거해야 합니다. 드라이버는 다음 시스템 작업의 결과로 리소스를 등록 취소할 수 있습니다.

  • I/O 리소스가 변경되면 디바이스의 균형을 다시 조정합니다.
  • 리소스가 제거되거나 생성되면 디바이스 전원 전환(D0<- ->Dx) 예를 들어 Dx로 이동할 때 인터럽트 연결이 끊어지고 D0으로 다시 이동하여 다시 연결될 수 있습니다.
  • 처리 중지, 서프라이즈 제거, 플러그 앤 플레이 이벤트를 제거합니다.
  • 연결된 오디오 엔드포인트가 사라지면 예를 들어 엔드포인트의 데이터 스트림을 처리하기 위해 스레드가 만들어지고 엔드포인트가 제거되는 경우입니다. 이 경우 드라이버는 스레드 스트림 리소스를 제거해야 합니다.
오디오 드라이버는 이 호출을 수행할 때 리소스가 유효한지 확인해야 합니다.

Windows 10만 실행되는 오디오 드라이버는 PcAddStreamResource 및 PcRemoveStreamResource를 사용할 수 있습니다. 이전 버전의 Windows에서도 실행해야 하는 Audio waveRT 미니포트 드라이버의 경우 AddStreamResource 및 RemoveStreamResource를 사용합니다.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows 10
지원되는 최소 서버 Windows Server 2016
대상 플랫폼 Windows
헤더 portcls.h
라이브러리 Portcls.lib
DLL 해당 없음
IRQL PASSIVE_LEVEL

추가 정보

PCSTREAMRESOURCE_DESCRIPTOR

PcAddStreamResource

PcStreamResourceType