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

Статья
02/07/2025

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

Синтаксис

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

Параметры

[in] Irp

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

[in] Pin

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

[out] Data

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

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

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

Замечания

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

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

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

KSNODETYPE_SPEAKER

KSNODETYPE_DESKTOP_SPEAKER

KSNODETYPE_ROOM_SPEAKER

KSNODETYPE_LOW_FREQUENCY_EFFECTS_SPEAKER

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Доступно в Windows 7 и более поздних версиях Windows.
целевая платформа	Всеобщий
заголовка	portcls.h (include Portcls.h)
IRQL	PASSIVE_LEVEL.