IXtfInputClient::ConnectGamepad 메서드

가상 컨트롤러를 만들고 이에 대한 장치 식별자를 가져옵니다.

구문

public:
HRESULT ConnectGamepad(
         UINT64 *pControllerId
)  

매개 변수

pControllerId
형식: UINT64 *

이 IXtfInputClient의 장치 식별자를 수신하는 UINT64에 대한 포인터입니다.

반환 값

형식: HRESULT

HRESULT 성공 또는 오류 코드입니다.

비고

ConnectGamepad는 생성된 각 가상 컨트롤러에 대한 시스템 리소스를 할당하고 IXtfInputClient::SendGamepadReport를 사용하여 개발 본체에 입력을 보내는 데 사용될 가상 컨트롤러의 식별자를 반환합니다. 본체의 새 컨트롤러 등록이 완료되고 입력을 수신할 준비가 될 수 있도록 코드에서 ConnectGamepad를 호출한 후 2초 동안 기다리고 나서 SendGamepadReport를 호출해야 합니다. 재사용을 위해 시스템 리소스가 해제되도록 코드에서는 항상 ConnectGamepad 호출을 DisconnectGamepad 호출과 연결해야 합니다. IXtfInputClient::DisconnectAllGamepads를 호출하여 모든 가상 컨트롤러 리소스를 동시에 해제할 수도 있습니다.

요건

헤더: xtfinput.h

라이브러리: xtfinput.lib

지원되는 플랫폼: Windows(Xbox 콘솔 도구용)

참고 항목

XtfInput
IXtfInputClient
IXtfInputClient::ConnectGamepad
IXtfInputClient::DisconnectGamepad
IXtfInputClient::DisconnectAllGamepads