IPinName::GetPinName 메서드(portcls.h)

아티클
02/29/2024

메서드는 GetPinName 오디오 엔드포인트의 식별 이름을 검색합니다. 핀에 대한 자세한 내용은 필터, 핀 및 노드 속성을 참조하세요.

구문

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

매개 변수

[in] Irp

IRP(I/O 요청 패킷) 구조체에 대한 포인터를 지정합니다. 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

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 7 및 이후 버전의 Windows에서 사용할 수 있습니다.
대상 플랫폼	유니버설
헤더	portcls.h(Portcls.h 포함)
IRQL	PASSIVE_LEVEL.