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