CeDriverPerformCallback
Other versions of this page are also available for the following:
.gif "A hyphen indicates that the information in this topic is not relevant for this platform, or that the platform does not support the API that is listed.")
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
8/28/2008
This function is used by a driver to perform callback upon IO completion.
Syntax
BOOL CeDriverPerformCallback(
HANDLE hCallback,
DWORD dwIoControlCode,
LPVOID lpInBuf,
DWORD nInBufSize,
LPVOID lpOutBuf,
DWORD nOutBufSize,
LPDWORD lpBytesReturned,
LPOVERLAPPED lpOverlapped
);
Parameters
- hCallback
[in] Specifies a handle to a handle-based API.
- dwIoControlCode
[in] IOCTL for the operation. This value identifies the specific operation to perform and the type of device on which to perform the operation. There are no specific values defined for the dwIoControlCode parameter. However, you can define custom IOCTL_XXX IOCTLs with the CTL_CODE macro. You can then advertise these IOCTLs and an application can use these IOCTLs with DeviceIoControl to perform the driver-specific functions.
- lpInBuf
[in] Long pointer to a buffer that contains the data required to perform the operation. Set to NULL if the dwIoControlCode parameter specifies an operation that does not require input data.
- nInBufSize
[in] Size, in bytes, of the buffer pointed to by lpInBuf.
- lpOutBuf
[out] Long pointer to a buffer that receives the output data for the operation. Set to NULL if the dwIoControlCode parameter specifies an operation that does not produce output data.
- nOutBufSize
[out] Size, in bytes, of the buffer pointed to by lpOutBuf.
- lpBytesReturned
[out] Long pointer to a variable that receives the size, in bytes, of the data stored in lpOutBuffer.
- lpOverlapped
[in] Ignored; set to NULL.
Return Value
Returns a non-zero value on success. Returns zero on failure. For extended error information, call GetLastError
Remarks
During IO request, if caller is from a different processor, call CeDriverDuplicateCallerHandle prior to using this function.
Requirements
| Header | ceddk.h |
| Library | CEDDK.lib |
| Windows Embedded CE | Windows Embedded CE 6.0 and later |