|Microsoft DirectX 9.0|
Note The IDvdInfo interface is deprecated. Use IDvdInfo2 instead.
Retrieves the root directory that is set in the player.
HRESULT GetRoot( LPSTR pRoot, ULONG cbBufSize, ULONG *pcbActualSize );
[out, size_is(cbBufSize)] Pointer to the buffer to receive the root string. Note that the root string uses ANSI characters.
[in] Size of buffer passed in, in bytes.
[out] Pointer to a value containing the size of the actual data returned.
Returns an HRESULT value.
|E_UNEXPECTED||DVD is not initialized or domain is not DVD_DOMAIN_Title.|
|VFW_E_DVD_INVALIDDOMAIN||Requested action is not supported on this domain (DVD_DOMAIN).|
|VFW_E_DVD_OPERATION_INHIBITED||Requested action cannot occur at this point in the movie due to the authoring of the current DVD-Video disc.|
If a valid root was found, this method returns the root string. Otherwise, it returns zero for pcbActualSize, indicating that a valid root directory has not been found or initialized.