ASYNC_COMPLETION 콜백 함수(tspi.h)

Completion_Proc TAPI에서 구현하고 서비스 공급자에게 TSPI_providerInit 매개 변수로 제공하는 콜백 함수입니다. 서비스 공급자는 이 함수를 호출하여 비동기적으로 실행되는 회선 또는 전화 프로시저의 완료를 보고합니다.

ASYNC_COMPLETION 형식은 이 콜백 함수에 대한 포인터를 정의합니다. Completion_Proc 애플리케이션 정의 함수 이름의 자리 표시자입니다.

구문

ASYNC_COMPLETION AsyncCompletion;

void AsyncCompletion(
  DRV_REQUESTID dwRequestID,
  LONG lResult
)
{...}

매개 변수

dwRequestID

서비스 공급자가 비동기적으로 실행한 원래 요청에 전달된 식별자입니다.

lResult

작업의 결과입니다. 성공을 나타내는 0이거나 오류를 나타내는 음수일 수 있습니다. 함수에서 발생할 수 있는 가능한 특정 오류 값은 비동기 또는 동기 실행에 대해 동일합니다.

반환 값

없음

설명

이 함수를 호출할 때 호출 상태는 모든 상태일 수 있습니다.

이 절차는 서비스 공급자가 TSPI_providerInit 함수를 사용하여 초기화될 때 TAPI에서 제공합니다. 라인, 통화 및 전화 디바이스에서 작동하는 일부 TSPI 프로시저는 비동기 작업을 지정합니다. 이러한 절차에는 요청을 식별하는 dwRequestID 매개 변수가 포함됩니다. 이러한 프로시저가 호출되면 서비스 공급자는 오류가 즉시 감지되면 음수를 반환하거나 작업이 비동기적으로 계속되면 양수 dwRequestID 를 반환할 수 있습니다. 서비스 공급자는 비동기적으로 실행되는 각 요청에 대해 완료를 정확히 한 번 보고해야 합니다. 이 절차를 호출하여 수행합니다. 서비스 공급자는 이 프로시저가 반환될 때까지 이 프로시저 또는 Line_Event 또는 Phone_Event 프로시저를 다시 호출할 수 없습니다.

서비스 공급자는 첫 번째 요청에서 반환되기 전에 Completion_Proc 함수를 호출할 수 있습니다. TAPI는 명시된 경우를 제외하고 Completion_Proc 컨텍스트 내에서 서비스 공급자를 호출하지 않도록 보장합니다.

해당 수준에서 비동기 함수 완성은 자발적인 이벤트 메시지에 사용되는 동일한 콜백 인터페이스를 통해 전달되는 메시지로 보고되기 때문에 TAPI 수준에서 직접 대응하지 않습니다. TSPI 수준에서는 Line_Event 및 Phone_Event 콜백 프로시저를 통해 자발적인 이벤트가 보고 됩니다.

요구 사항

추가 정보

Line_Event

Phone_Event

TSPI_providerInit