IDvdControl::ParentalCountrySelect method (strmif.h)

Article
02/22/2024

[The feature associated with this page, DirectShow, is a legacy feature. It has been superseded by MediaPlayer, IMFMediaEngine, and Audio/Video Capture in Media Foundation. Those features have been optimized for Windows 10 and Windows 11. Microsoft strongly recommends that new code use MediaPlayer, IMFMediaEngine and Audio/Video Capture in Media Foundation instead of DirectShow, when possible. Microsoft suggests that existing code that uses the legacy APIs be rewritten to use the new APIs if possible.]

Note The IDvdControl interface is deprecated. Use IDvdControl2 instread.

Sets the current country/region for controlling parental access levels.

Syntax

HRESULT ParentalCountrySelect(
  [in] WORD wCountry
);

Parameters

[in] wCountry

Value that specifies the current country/region according to the Alpha-2 Code defined in ISO3166. See Remarks.

Return value

Returns an HRESULT value.

Remarks

This method returns an error unless the domain is DVD_DOMAIN_Stop. For more information, see DVD_DOMAIN.

The ISO3166 2-letter country/region codes in the wCountry parameter must be supplied to this method as a WORD. The conversion is demonstrated for the United States (US) in the following line of code.

C++
WORD wCountry = ( WORD( 'U' ) << 8 ) \| 'S';

Requirements

Requirement	Value
Target Platform	Windows
Header	strmif.h (include Dshow.h)