| Microsoft DirectX 8.1 (C++) |
The ShowDialog method displays the specified dialog box.
Syntax
HRESULT ShowDialog(
int iDialog,
HWND hwnd
);
Parameters
iDialog
[in] Dialog box to display. This is a member of the VfwCaptureDialogs enumeration.
hwnd
[in] Handle of the dialog box's parent window.
Return Values
Returns an HRESULT value that depends on the implementation of the interface.
Remarks
You can't use this method when 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.
IAMVfwCaptureDialogs::ShowDialog calls the Video for Windows® VideoDialog function to display the appropriate dialog box.
If you use this method to bring up a VfwCaptureDialog_Format dialog box, it will return the VFW_E_CANNOT_CONNECT error code if a capture filter is already connected in a graph and the existing graph cannot accept the new format. Capture applications must rebuild the part of the filter graph that is downstream of the capture filter if this error occurs.
See Also