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