Skip to main content

XtfGetConsoleInfoList

콘솔에 대한 정보를 포함하는 XtfConsoleInfo 객체를 반환합니다.

구문

매개 변수

address
형식: PCWSTR
[in] 콘솔의 주소입니다. hConsoleInfo
형식: XtfConsoleInfo*
[out] 콘솔에 대한 정보를 검색하기 위해 XtfGetConsoleFieldValue 함수와 함께 사용할 포인터입니다.

반환 값

형식: HRESULT 함수가 성공하고 XtfGetConsoleFieldValue를 사용하여 hConsoleInfo에서 값을 검색할 수 있으면 S_OK를 반환합니다. 그렇지 않으면 HRESULT 오류 코드를 반환합니다.

설명

콘솔에 대한 정보를 검색하려면 먼저 이 함수를 사용하여 XtfConsoleInfo 포인터를 가져온 다음 XtfGetConsoleFieldValue를 사용하여 해당 포인터에서 콘솔에 대한 정보를 검색합니다. 필요한 정보를 검색한 후에는 XtfCloseConsoleInfoList를 사용하여 반환된 XtfConsoleInfo 포인터와 관련된 리소스를 해제합니다.
XtfGetConsoleInfoList는 콘솔의 모든 정보를 검색하고 해당 정보에 대한 포인터를 제공합니다. XtfGetConsoleFieldValue는 검색된 정보만 반복합니다. 콘솔에 대한 정보를 검색하려면 두 함수를 함께 사용해야 합니다.
이 함수의 address에 지정된 대상 콘솔이 프로비저닝되지 않은 경우, fieldXtfConsoleFieldId::DeviceID가 지정되어 있으면 XtfGetConsoleFieldValue 함수는 빈 값을 반환합니다.
다음 코드 샘플은 개발 콘솔의 콘솔 ID를 검색하기 위해 XtfGetConsoleInfoListXtfGetConsoleFieldValue 함수를 함께 사용하는 방법을 보여 줍니다.

요구 사항

헤더: xtfapi.h 라이브러리: XtfApi.lib 지원 플랫폼: Windows(XBOX 콘솔 도구용)

함께 보기

XtfConsoleControl
XBOX Tools Framework
마지막 수정일 2026년 8월 24일