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

Статья
02/29/2024

Метод 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.