APIDb_DrawOrderGetNextID

BTF/STB 시스템에 의해 지정된 순서대로 현재 데이터베이스의 다음 요소에 대한 레퍼런스를 리턴합니다.

    GSErrCode ACAPI_Database (
        APIDb_DrawOrderGetNextID,
        API_ElemFilterFlags     filterBits,
        API_Elem_Head*          elemHead
    );

 

파라미터

filterBits

[in] 요소 필드 속성들입니다. (VALUE로서 전달함)

elemHead

[out] 요소 레퍼런스입니다.

 

리턴 값

NoError

함수가 성공적으로 완료되었습니다.

APIERR_BADPARS

elemHead가 NULL입니다.

APIERR_NOMORE

리스트에 더 이상 요소가 없습니다.

다른 공통 API 오류들에 대해서는 API 오류 문서를 보십시오.

 

설명

이 함수는 서버 애플리케이션이 디스플레이에 그리는 순서대로 데이터베이스 요소들을 가져오는 데 사용합니다. 루프는 APIDb_DrawOrderInit 함수로 초기화되어야 합니다.

특정 프로퍼티들을 가진 요소들을 생략하기 위해 (VALUE로서) 필터 비트들을 전달하십시오; 예제에 나온 것처럼 하십시오. ACAPI_Element_Filter에서 이 주제에 대해 더 자세한 것들을 보십시오.

 

예제

API_Elem_Head       elem_head;
GSErrCode           err;

err = ACAPI_Database (APIDb_DrawOrderInitID, NULL, NULL);
while (err == NoError) {
    err = ACAPI_Database (APIDb_DrawOrderGetNextID, (void *) (Int32) APIFilt_OnActFloor, &elem_head);
    if (err == NoError) {
        /* ... */
    }
}
if (err == APIERR_NOMORE)
    err = NoError;

 

요구사항

버전: API 4.1 또는 이후

헤더: APIdefs_Database.h

 

참고사항

APIDb_DrawOrderInit , ACAPI_Element_Filter
ACAPI_Database, API 함수