Функция PcRemoveStreamResource (portcls.h)

PcRemoveStreamResource удаляет существующий ресурс потока. PcRemoveStreamResource может вызываться любым драйвером, в том числе драйверами минипорта WaveRT без звука, которые имеют прерывания или потоки, связанные с аудиопотоком. Он также может вызываться драйверами минипорта Audio WaveRT.

Синтаксис

PORTCLASSAPI NTSTATUS PcRemoveStreamResource(
  [in] PCSTREAMRESOURCE ResourceHandle
);

Параметры

[in] ResourceHandle

PCSTREAMRESOURCE — дескриптор ресурсов, возвращаемый pcAddStreamResource.
Дополнительные сведения см. в разделе PcAddStreamResource и PCSTREAMRESOURCE_DESCRIPTOR.

Возвращаемое значение

STATUS_SUCCESS — драйвер смог зарегистрировать ресурс указанного PDO.

STATUS_INVALID_PARAMETER . Драйвер возвращает эту ошибку, если он находит любой другой недопустимый параметр, помимо конкретных случаев для других экземпляров состояния ошибки.

Могут быть возвращены дополнительные стандартные коды состояния.

Замечания

Чтобы обеспечить работу без сбоев, звуковые драйверы должны зарегистрировать свои ресурсы потоковой передачи с помощью портов. Это позволяет ОС управлять ресурсами, чтобы избежать помех между потоковой передачей звука и другими подсистемами.

Потоковые ресурсы — это все ресурсы, используемые звуковым драйвером для обработки аудиопотоков или обеспечения потока аудиопотоков.

Звуковые драйверы должны удалить ранее зарегистрированный ресурс. Драйверы могут отменить регистрацию ресурса в результате следующих системных действий:

• Перебалансируйте устройство при изменении ресурсов ввода-вывода.
• Переход питания устройства (D0<- ->Dx) при уничтожении или создании ресурсов. Например, прерывания могут быть отключены при переходе в Dx и повторно подключены к D0.
• При обработке остановки, неожиданного удаления, удаления событий подключаемых модулей и воспроизведения.
• При удалении связанных конечных точек звука. Например, если поток создается для обработки потока данных конечной точки, а конечная точка удаляется. В этом случае драйвер должен удалить ресурс потока потока.

Звуковой драйвер должен убедиться, что ресурс действителен при выполнении этого вызова.

Звуковые драйверы, которые работают только в Windows 10, могут использовать PcAddStreamResource и PcRemoveStreamResource. Для драйверов минипорта Audio WaveRT, которые также должны выполняться в предыдущих версиях Windows, используйте AddStreamResource и RemoveStreamResource.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows 10
минимальный поддерживаемый сервер	Windows Server 2016
целевая платформа	Виндоус
заголовка	portcls.h
библиотеки	Portcls.lib
DLL	NA
IRQL	PASSIVE_LEVEL

См. также

PCSTREAMRESOURCE_DESCRIPTOR

PcAddStreamResource

PcStreamResourceType