IPinName::GetPinName 메서드(portcls.h)
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 메서드를 지원하지 않는다고 결정한 경우 클라이언트는 토폴로지 브리지 핀의 이름을 사용합니다. 고정 범주 및 친숙한 이름에 대한 자세한 내용은 Pin Category 속성 및 오디오 엔드포인트 디바이스 친숙한 이름을 참조하세요.
자세한 내용은
참고 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. |
참고 항목
오디오 엔드포인트 디바이스 이름
팩터리 고정
범주 속성 고정