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 |