IPinName：：GetPinName 方法（portcls.h）

GetPinName 方法检索音频终结点的友好名称。有关引脚的详细信息，请参阅筛选器、固定和节点属性。

语法

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

[in] Irp

指定指向 I/O 请求数据包（IRP）结构的指针。有关 IRP 的详细信息，请参阅 IRP 和 I/O 请求数据包。

[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