CardRequestSocketMask (Windows CE 3.0 Device Driver Developement)

Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.

This function associates a socket and function pair with an event mask for the driver. Card Services then restricts its future callbacks to the driver to those associated with the event mask passed to this function.

STATUS CardRequestSocketMask(
CARD_CLIENT_HANDLE
hCardClient
CARD_SOCKET_HANDLE
hSock
UINT16
fEventMask
);

Parameters

hCardClient

Handle obtained from the CardRegisterClientfunction.

hSock

Handle to a socket and function pair.

fEventMask

Specifies a bitmask indicating the events that trigger a callback. The allowable card events are listed in the Cardserv.h header file.

Return Values

CERR_SUCCESS indicates success. One of the following values indicates failure:

CERR_BAD_HANDLE

Indicates that the driver handle specified for hCardClientis invalid.

CERR_BAD_SOCKET

Indicates that the socket identifier specified for hSockis invalid.

CERR_OUT_OF_RESOURCE

Indicates that insufficient memory is available to create a new event mask.

Remarks

An event mask should not be confused with the global event mask, which pertains to all sockets and is set by CardRegisterClient.

The CardSetEventMaskfunction can change either a socket-specific event mask or the mask specified by CardRegisterClient.

Driver name

PCMCIA

Requirements

Runs on	Versions	Defined in	Include	Link to
Windows CE OS	1.0 and later

Note This API is part of the complete Windows CE OS package as provided by Microsoft. The functionality of a particular platform is determined by the original equipment manufacturer (OEM) and some devices may not support this API.

See Also

CardReleaseSocketMask

Last updated on Tuesday, July 13, 2004