Microsoft DirectX 9.0


The ShowDialog method displays the specified VFW dialog box.


HRESULT ShowDialog(
  int iDialog,
  HWND hwnd



[in] Dialog box to display. This is a member of the VfwCaptureDialogs enumeration.


[in] Handle of the dialog box's parent window.

Return Values

Returns an HRESULT value. Possible values include the following.

Value Description
E_INVALIDARG Invalid argument.
S_OK Success.
VFW_E_CANNOT_CONNECT Could not reconnect with the new format.
VFW_E_NOT_STOPPED The filter graph is not stopped.


Stop the filter graph before calling this method. Otherwise, the method fails and returns VFW_E_NOT_STOPPED.

The Video Format dialog (VfwCaptureDialog_Format) may change the video format. If so, the method tries to reconnect the capture filter. If the downstream filter rejects the new format, the method returns VFW_E_CANNOT_CONNECT.

See Also