Метод IPortClsStreamResourceManager::RemoveStreamResource (portcls.h)
RemoveStreamResource удаляет существующий ресурс потока. Метод RemoveStreamResource может использоваться только драйверами минипорта audio waveRT.
Синтаксис
NTSTATUS RemoveStreamResource(
PCSTREAMRESOURCE ResourceHandle
);
Параметры
ResourceHandle
PCSTREAMRESOURCE — дескриптор ресурса, возвращаемый pcAddStreamResource. Дополнительные сведения см. в разделе PcAddStreamResource.
Возвращаемое значение
Этот метод возвращает NTSTATUS, который содержит:
- STATUS_SUCCESS — драйвер смог зарегистрировать ресурс указанного PDO.
- STATUS_INVALID_PARAMETER — драйвер возвращает эту ошибку, если он считает какой-либо другой параметр недопустимым, кроме конкретных случаев для других экземпляров состояния ошибки.
Могут возвращаться дополнительные стандартные коды состояния.
Комментарии
Чтобы обеспечить бесперебойную работу, аудиодрайверы должны зарегистрировать свои ресурсы потоковой передачи с помощью portcls. Это позволяет ОС управлять ресурсами, чтобы избежать помех между потоковой передачей звука и другими подсистемами. Stream ресурсы — это любые ресурсы, используемые аудиодрайвером для обработки аудиопотоков или обеспечения потока аудиоданных.
Аудиодрайверы должны удалить ранее зарегистрированный ресурс. Драйверы могут отменить регистрацию ресурса в результате следующих системных действий:
- Перебалансируйте устройство при изменении ресурсов ввода-вывода.
- При уничтожении или создании ресурсов происходит смена питания устройства (D0-Dx<>). Например, прерывания могут быть отключены при переходе в Dx и повторно подключены с возвратом к D0.
- При остановке обработки, неожиданном удалении, удалении событий plug and play.
- Если связанные конечные точки звука исчезнут. Например, если поток создается для обработки потока данных конечной точки и конечная точка удаляется. В этом случае драйвер должен удалить ресурс потока потока.
Аудиодрайвер должен убедиться, что ресурс действителен при выполнении этого вызова.
Требования
| Требование | Значение |
|---|---|
| Заголовок | portcls.h |
| IRQL | PASSIVE_LEVEL |