struktur NDIS_CO_CLIENT_OPTIONAL_HANDLERS (ndis.h)

Artikel
08/07/2023

Struktur NDIS_CO_CLIENT_OPTIONAL_HANDLERS menentukan titik masuk untuk fungsi ProtocolXxx klien CoNDIS untuk driver protokol yang meneruskan struktur ini ke Fungsi NdisSetOptionalHandlers .

Sintaks

typedef struct _NDIS_CO_CLIENT_OPTIONAL_HANDLERS {
  NDIS_OBJECT_HEADER                  Header;
  ULONG                               Reserved;
  CO_CREATE_VC_HANDLER                ClCreateVcHandler;
  CO_DELETE_VC_HANDLER                ClDeleteVcHandler;
  CO_OID_REQUEST_HANDLER              ClOidRequestHandler;
  CO_OID_REQUEST_COMPLETE_HANDLER     ClOidRequestCompleteHandler;
  CL_OPEN_AF_COMPLETE_HANDLER_EX      ClOpenAfCompleteHandlerEx;
  CL_CLOSE_AF_COMPLETE_HANDLER        ClCloseAfCompleteHandler;
  CL_REG_SAP_COMPLETE_HANDLER         ClRegisterSapCompleteHandler;
  CL_DEREG_SAP_COMPLETE_HANDLER       ClDeregisterSapCompleteHandler;
  CL_MAKE_CALL_COMPLETE_HANDLER       ClMakeCallCompleteHandler;
  CL_MODIFY_CALL_QOS_COMPLETE_HANDLER ClModifyCallQoSCompleteHandler;
  CL_CLOSE_CALL_COMPLETE_HANDLER      ClCloseCallCompleteHandler;
  CL_ADD_PARTY_COMPLETE_HANDLER       ClAddPartyCompleteHandler;
  CL_DROP_PARTY_COMPLETE_HANDLER      ClDropPartyCompleteHandler;
  CL_INCOMING_CALL_HANDLER            ClIncomingCallHandler;
  CL_INCOMING_CALL_QOS_CHANGE_HANDLER ClIncomingCallQoSChangeHandler;
  CL_INCOMING_CLOSE_CALL_HANDLER      ClIncomingCloseCallHandler;
  CL_INCOMING_DROP_PARTY_HANDLER      ClIncomingDropPartyHandler;
  CL_CALL_CONNECTED_HANDLER           ClCallConnectedHandler;
  CL_NOTIFY_CLOSE_AF_HANDLER          ClNotifyCloseAfHandler;
} NDIS_CO_CLIENT_OPTIONAL_HANDLERS, *PNDIS_CO_CLIENT_OPTIONAL_HANDLERS;

Anggota

Header

Struktur NDIS_OBJECT_HEADER untuk struktur karakteristik CoNDIS driver protokol (NDIS_CO_CLIENT_OPTIONAL_HANDLERS). Driver mengatur
Ketik anggota struktur yang ditentukan Header untuk NDIS_OBJECT_TYPE_CO_CLIENT_OPTIONAL_HANDLERS, anggota Revisi ke NDIS_CO_CLIENT_OPTIONAL_HANDLERS_REVISION_1, dan anggota Ukuran yang akan NDIS_SIZEOF_CO_CLIENT_OPTIONAL_HANDLERS_REVISION_1.

Reserved

Dicadangkan untuk NDIS.

ClCreateVcHandler

Titik masuk fungsi ProtocolCoCreateVc penelepon.

ClDeleteVcHandler

Titik masuk fungsi ProtocolCoDeleteVc penelepon .

ClOidRequestHandler

Titik masuk penelepon Fungsi ProtocolCoOidRequest .

ClOidRequestCompleteHandler

Titik masuk penelepon Fungsi ProtocolCoOidRequestComplete .

ClOpenAfCompleteHandlerEx

Titik masuk penelepon Fungsi ProtocolClOpenAfCompleteEx .

ClCloseAfCompleteHandler

Titik masuk penelepon Fungsi ProtocolClCloseAfComplete .

ClRegisterSapCompleteHandler

Titik masuk penelepon Fungsi ProtocolClRegisterSapComplete . Klien menggunakan fungsi ini untuk menerima panggilan masuk dari komputer jarak jauh.

ClDeregisterSapCompleteHandler

Titik masuk penelepon Fungsi ProtocolClDeregisterSapComplete .

ClMakeCallCompleteHandler

Titik masuk penelepon Fungsi ProtocolClMakeCallComplete . Klien menggunakan fungsi ini untuk melakukan panggilan keluar ke komputer jarak jauh.

ClModifyCallQoSCompleteHandler

Titik masuk penelepon Fungsi ProtocolClModifyCallQoSComplete . Klien menggunakan fungsi ini untuk secara dinamis membuat perubahan dalam kualitas layanan (QoS) pada koneksi virtual (VC) yang dibuat atau untuk bernegosiasi dengan manajer panggilan untuk membuat QoS ketika klien menyiapkan panggilan masuk.

ClCloseCallCompleteHandler

Titik masuk penelepon Fungsi ProtocolClCloseCallComplete .

ClAddPartyCompleteHandler

Titik masuk penelepon Fungsi ProtocolClAddPartyComplete . Klien menggunakan fungsi ini untuk membuat VC point-to-multipoint untuk panggilan keluar ke komputer jarak jauh.

ClDropPartyCompleteHandler

Titik masuk penelepon Fungsi ProtocolClDropPartyComplete .

ClIncomingCallHandler

Titik masuk penelepon Fungsi ProtocolClIncomingCall . Klien menggunakan fungsi ini untuk menerima panggilan masuk dari komputer jarak jauh.

ClIncomingCallQoSChangeHandler

Titik masuk penelepon Fungsi ProtocolClIncomingCallQoSChange . Klien menggunakan fungsi ini untuk menerima panggilan masuk dari komputer jarak jauh tempat klien pengirim dapat mengubah QoS secara dinamis.

ClIncomingCloseCallHandler

Titik masuk penelepon Fungsi ProtocolClIncomingCloseCall .

ClIncomingDropPartyHandler

Titik masuk penelepon Fungsi ProtocolClIncomingDropParty .

ClCallConnectedHandler

Titik masuk penelepon Fungsi ProtocolClCallConnected . Klien menggunakan fungsi ini untuk menerima panggilan masuk dari komputer jarak jauh.

ClNotifyCloseAfHandler

Titik masuk penelepon Fungsi ProtocolClNotifyCloseAf .

Keterangan

Untuk menentukan titik masuk sebagai klien CoNDIS, driver protokol menginisialisasi struktur NDIS_CO_CLIENT_OPTIONAL_HANDLERS dan meneruskannya ke Fungsi NdisSetOptionalHandlers .

Klien memanggil NdisSetOptionalHandlers dari fungsi ProtocolSetOptions . Klien harus mengatur setiap anggota ClXxx dalam struktur NDIS_CO_CLIENT_OPTIONAL_HANDLERS ke fungsi ProtocolXxxx yang disediakan pemanggil, bahkan jika manajer panggilan tidak mendukung panggilan masuk, panggilan keluar, atau koneksi point-to-multipoint. Untuk subset fungsionalitas berorientasi koneksi apa pun yang tidak didukung klien, fungsi ProtocolXxx tempat penampungnya harus mengembalikan NDIS_STATUS_NOT_SUPPORTED.