Microsoft DirectX 9.0


The ShowDialog method displays the specified dialog box.


HRESULT ShowDialog(
  int iDialog,
  HWND hwnd



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


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

Return Values

Returns an HRESULT value that depends on the implementation of the interface.


This method returns an error when asked to display a dialog box while the driver is streaming or displaying another dialog box. While the driver displays the dialog box you can't stream (pause or run) the filter.

IAMVfwCompressDialogs::ShowDialog calls the Video for Windows video compression manager (VCM) functions ICConfigure, ICAbout, ICQueryConfigure, and ICQueryAbout to display the appropriate dialog box or determine if one exists.

The VfwCompressDialog_QueryConfig and VfwCompressDialog_QueryAbout members of the VfwCompressDialogs enumeration tell you whether or not the configure dialog or about dialog is available. If passed one of these flags, the filter will return S_OK if the dialog exists, and S_FALSE if it does not. If a dialog is available, you call ShowDialog with the value VfwCompressDialog_Config or VfwCompressDialog_About to bring up the dialog.

See Also