Share via

IOCTL_STREAM_START_XMIT_SESSION

  • Article

This IOCTL permits the caller to initiate a transmit session, that is, set up the connection and details to be able to transmit DV, MPEG, audio, or other isochronous data to the device.

Parameters

  • hDevice
    [in] Handle to the target object. To get a device handle, call the CreateFile function with a name dynamically obtained from the SetupDiEnumDeviceInterfaces function.
  • dwIoControlCode
    [in] IOCTL for the operation. This value identifies the target operation and the type of device on which to perform the operation. For this operation, use IOCTL_STREAM_START_XMIT_SESSION.
  • lpInBuffer
    [in] Must be filled in with a properly initialized STREAM_StartTransmitSession_Request structure. The ssts_RemotePlug, ssts_LocalPlug, ssts_MediaType, ssts_MaximumThroughput, ssts_ClusterDimension, and ssts_SampleFrequency members must be pre-initialized.
  • nInBufferSize
    [in] Set to sizeof(STREAM_StartTransmitSession_Request).
  • lpOutBuffer
    [out] Must point to a STREAM_StartTransmitSession_Response structure.
  • nOutBufferSize
    [in] Set to sizeof(STREAM_StartTransmitSession_Response).
  • lpBytesReturned
    [out] Pointer to a DWORD variable that receives the actual count of bytes returned by the function in the output buffer.
  • lpOverlapped
    [out] If not used, set to NULL. Otherwise, this should point to a completely filled out OVERLAPPED structure that contains a valid event. The event will be signaled when the I/O operation is complete.

Return Values

If the operation succeeds, the DeviceIoControl function returns a non-zero value. If the operation fails, DeviceIoControl returns zero. To obtain extended error information, call the GetLastError function.

Remarks

This IOCTL sets up the details of generating a connection to the device in question on the given AV/C plug and transmitting video data on that connection.

Requirements

OS Versions: Windows CE .NET 4.0 and later.
Header: Avc_stream.h.

See Also

CreateFile | DeviceIoControl | IOCTL_STREAM_ATTACH_BUFFER | IOCTL_STREAM_DETACH_BUFFER | IOCTL_STREAM_QUERY_BUFFER_STATE | IOCTL_STREAM_STOP_SESSION | STREAM_StartTransmitSession_Request | STREAM_StartTransmitSession_Response

 Last updated on Tuesday, May 18, 2004

© 1992-2003 Microsoft Corporation. All rights reserved.