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

  • Статья

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

Синтаксис

PORTCLASSAPI NTSTATUS PcRemoveStreamResource(
  [in] PCSTREAMRESOURCE ResourceHandle
);

Параметры

[in] ResourceHandle

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

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

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

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

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

Комментарии

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

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

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

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

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

Требования

Требование Значение
Минимальная версия клиента Windows 10
Минимальная версия сервера Windows Server 2016
Целевая платформа Windows
Header portcls.h
Библиотека Portcls.lib
DLL Н/Д
IRQL PASSIVE_LEVEL

См. также раздел

PCSTREAMRESOURCE_DESCRIPTOR

PcAddStreamResource

PcStreamResourceType