CardRegisterClient

9/8/2008

Essa função registra um função callback que é chamado pelos serviços cartão quando ocorre um evento especificado Soquete. O função callback notifica o driver do evento, such as inserção cartão, para que o driver possa tirar o apropriado ação.

Syntax

CARD_CLIENT_HANDLE CardRegisterClient(
  CLIENT_CALLBACK CallBackFn,
  PCARD_REGISTER_PARMS pParms 
);

Parameters

• CallBackFn
  [no] Ponteiro para função callback do driver.

• pParms
  [no] Ponteiro para um CARD_REGISTER_PARMS estrutura definindo as características do driver.

Return Value

Um identificador driver indica sucesso. NULL Indica falha, e GetLastError Retorna um dos seguinte valores:

• CERR_BAD_ARGS
  Indica que o ponteiro especificado no pParms Ou CallBackFn não é válido.

• CERR_OUT_OF_RESOURCE
  Indica que os serviços cartão é Não é possível alocar memória para controlar o driver.

Remarks

Essa função ativa a energia soquetes sem energia que contêm cartões PC para que o driver PC Card recém-registrado pode usar os cartões. Um driver pode notificações inserção artificial solicitação para verificar se um cartão que ele controla já tenha sido inserido.

Serviços cartão envia um codificar evento callback CE_CARD_INSERTION para cada função em cartões PC que atualmente são inseridos. Se o driver não requer inserção artificial avisos, ele poderá Clear o CLIENT_ATTR_NOTIFY_SHARED e CLIENT_ATTR_NOTIFY_EXCLUSIVE bits na fAttributes membro de CARD_REGISTER_PARMS.

Porque os retornos de chamada CE_CARD_INSERTION podem ocorrer antes essa função retorna, o Parm2 membro das CARD_EVENT_PARMS estrutura contém CARD_CLIENT_HANDLE do cliente de registrar. Pelo mesmo motivo, Parm1 Também contém identificador do cliente de registrar no callback de CE_REGISTRATION_COMPLETE.

Quando o driver é descarregado, ele deve chamar CardDeregisterClient a livre quaisquer recursos PC Card alocados para o driver.

Requirements

Header	cardsv2.h
Library	Pcc_serv.dll
Windows Embedded CE	Windows CE 1.0 and later

See Also

Reference

CARD_CLIENT_HANDLE
CARD_EVENT
CARD_EVENT_PARMS
CARD_REGISTER_PARMS
CardDeregisterClient