Поделиться через


Метод IPinName::GetPinName (portcls.h)

Метод GetPinName извлекает понятное имя конечной точки звука. Дополнительные сведения о закреплениях см. в разделе Свойства фильтра, закрепления и узла.

Синтаксис

NTSTATUS GetPinName(
  [in]  PIRP     Irp,
  [in]  PKSP_PIN Pin,
  [out] PVOID    Data
);

Параметры

[in] Irp

Указывает указатель на структуру пакета запросов ввода-вывода (IRP). Дополнительные сведения о irP см. в разделе Пакеты IRP и запросов ввода-вывода.

[in] Pin

Указывает указатель на базовый контакт потоковой передачи ядра (KS).

[out] Data

Указывает указатель на буфер, содержащий данные для GetPinName метода .

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

Метод GetPinName возвращает STATUS_SUCCESS, если вызов был успешным. В противном случае возвращается соответствующий код ошибки.

Комментарии

Если клиенту требуется имя текущего контакта конечной точки, но он определил, что драйвер мини-порта не поддерживает GetPinName метод , клиент использует понятное имя контакта моста топологии. Дополнительные сведения о категориях закрепления и понятных именах см. в разделах Закрепление свойства категории и Понятные имена для устройств конечных точек аудио.

Дополнительные сведения

Примечание В Windows 7 звуковой стек пользовательского режима не поддерживает настройку имени конечной точки динамиков. Таким образом, в Windows 7 метод работает только с конечными точками, GetPinName у которых нет понятного имени Speakers. В следующем списке показаны категории типов узлов KS, которым назначено понятное имя говорящего:
KSNODETYPE_SPEAKER
KSNODETYPE_DESKTOP_SPEAKER
KSNODETYPE_ROOM_SPEAKER
KSNODETYPE_LOW_FREQUENCY_EFFECTS_SPEAKER
 

Требования

Требование Значение
Минимальная версия клиента Доступно в Windows 7 и более поздних версиях Windows.
Целевая платформа Универсальное
Верхняя часть portcls.h (включая Portcls.h)
IRQL PASSIVE_LEVEL.

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

Понятные имена для конечных звуковых устройств

IPinName

Свойства фильтра, закрепления и узла

Фабрики контактов

Закрепление свойства категории

KSPROPSETID_Pin

Пакеты запросов ввода-вывода