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

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

См. также

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

IPinName

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

фабрики закреплений

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

KSPROPSETID_Pin

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

  • Last updated on