Share via


RDF_IOCTL_VENDOR (Windows Embedded CE 6.0)

1/6/2010

The RDF_IOCTL_VENDOR callback function performs vendor-specific IOCTL operations. This callback function is optional.

Syntax

NTSTATUS (*ReaderFunction[RDF_IOCTL_VENDOR])(
  PSMARTCARD_EXTENSION SmartcardExtension
);

Parameters

  • SmartcardExtension
    [in] Points to the smart card extension of the device. In this SMARTCARD_EXTENSION structure, the MajorIoControlCode member contains a vendor-specific IOCTL code. Refer to the macro SCARD_CTL_CODE in Winsmcrd.h for information on how to define a vendor-specific IOCTL code. Vendor-specific codes must be between 2048 and 4095. The RequestBuffer member of this structure's IoRequest member points to the user's input buffer. The RequestBufferLength member of this structure's IoRequest member contains the size of the user's input buffer. The ReplyBuffer member of this structures's IoReques member points to the user's output buffer. The ReplyBufferLength member of this structure's IoRequest member contains the size of the user's output buffer.

    On output, The Information member of this structure's IoRequest member must be set to the number of bytes returned.

Return Value

This function returns an NTSTATUS value. The value returned depends upon the function performed, because RDF_IOCTL_VENDOR is a vendor-defined IOCTL call. Possible values are the following.

Value Description

STATUS_SUCCESS

Function successfully executed.

STATUS_NO_MEDIA

No card is in the reader.

STATUS_IO_TIMEOUT

The request has timed out.

STATUS_BUFFER_TOO_SMALL

The user's reply buffer is too small.

STATUS_INVALID_DEVICE_REQUEST

The request is not valid for this IOCTL.

STATUS_PENDING

The operation is pending.

Requirements

Header smclib.h
Windows Embedded CE Windows CE 3.0 and later

See Also

Reference

Smart Card Driver Functions