IOCTL_STREAM_GET_MEDIA_SIZE

  • Article

This IOCTL retrieves the packet and frame sizes for a given medium type.

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_GET_MEDIA_SIZE.
  • lpInBuffer
    [in] Must be filled in with a properly initialized STREAM_GetMediaSize_Request structure. The sgms_MediaType member must be pre-initialized.
  • BufferSize
    [in] Set to sizeof(STREAM_GetMediaSize_Request).
  • lpOutBuffer
    [out] This field should be set to point to a STREAM_GetMediaSize_Response structure.
  • nOutBufferSize
    [in] This field should be pre-initialized with the maximum size of the lpOutBuffer. This should be at least sizeof(STREAM_GetMediaSize_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 call can be used to determine the expected size of buffers to be queued to the IOCTL_STREAM_ATTACH_BUFFER IOCTL.

Requirements

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

See Also

IOCTL_STREAM_SET_MEDIA_SIZE | IOCTL_STREAM_ATTACH_BUFFER | CreateFile | STREAM_GetMediaSize_Request | STREAM_GetMediaSize_Response | DeviceIoControl

 Last updated on Tuesday, May 18, 2004

© 1992-2003 Microsoft Corporation. All rights reserved.