BusIoControl (Windows Embedded CE 6.0)

1/6/2010

This function executes the CEDDK Dynamic-Link Library Bus Access IOCTLs.

Syntax

BOOL BusIoControl (
  HANDLE hBusAccess,
  DWORD dwIoControlCode, 
  LPVOID lpInBuffer, 
  DWORD nInBufferSize, 
  LPVOID lpOutBuffer, 
  DWORD nOutBufferSize, 
  LPDWORD lpBytesReturned, 
  LPOVERLAPPED lpOverlapped
);

Parameters

• hBusAccess
  [in] Handle obtained from CreateBusAccessHandle.

• 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 BusIoControl to perform the bus-specific functions.

• lpInBuffer
  [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.

• nInBufferSize
  [in] Size, in bytes, of the buffer pointed to by lpInBuffer.

• lpOutBuffer
  [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.

• nOutBufferSize
  [out] Size, in bytes, of the buffer pointed to by lpOutBuffer.

• lpBytesReturned
  [out] Long pointer to a variable that receives the size, in bytes, of the data stored into the buffer pointed to by lpOutBuffer. Even when an operation produces no output data, and lpOutBuffer is NULL, the BusIoControl function uses the variable pointed to by lpBytesReturned. After such an operation, the value of the variable has no meaning.

• lpOverlapped
  [in] Ignored; set to NULL.

Return Value

Returns TRUE if successful. Otherwise, it returns FALSE.

Requirements

See Also

Reference

CEDDK Dynamic-Link Library Bus Access Functions
CEDDK Dynamic-Link Library Bus Access IOCTLs
CreateBusAccessHandle

Other Resources

CTL_CODE