Metodo IDeviceInfo::GetRoot (strmif.h)

Articolo
07/28/2023

[La funzionalità associata a questa pagina, DirectShow, è una funzionalità legacy. È stata sostituita da MediaPlayer, IMFMediaEngine e Audio/Video Capture in Media Foundation. Queste funzionalità sono state ottimizzate per Windows 10 e Windows 11. Microsoft consiglia vivamente che il nuovo codice usi MediaPlayer, IMFMediaEngine e Audio/Video Capture in Media Foundation invece di DirectShow, quando possibile. Microsoft suggerisce che il codice esistente che usa le API legacy venga riscritto per usare le nuove API, se possibile.

Nota L'interfaccia INameInfo è deprecata. Usare invece IPredefinitoInfo2 .

Recupera la directory radice impostata nel lettore.

Sintassi

HRESULT GetRoot(
  [out] LPSTR pRoot,
  [in]  ULONG ulBufSize,
  [out] ULONG *pulActualSize
);

Parametri

[out] pRoot

Puntatore al buffer per ricevere la stringa radice. Si noti che la stringa radice usa caratteri ANSI.

[in] ulBufSize

Dimensione del buffer passata in byte.

[out] pulActualSize

Puntatore a un valore contenente le dimensioni dei dati effettivi restituiti.

Valore restituito

Restituisce un valore HRESULT .

Codice restituito	Descrizione
E_UNEXPECTED	IL DVD non viene inizializzato o il dominio non è DVD_DOMAIN_Title.
S_OK	Operazione completata.
VFW_E_DVD_INVALIDDOMAIN	L'azione richiesta non è supportata in questo dominio (DVD_DOMAIN).
VFW_E_DVD_OPERATION_INHIBITED	L'azione richiesta non può verificarsi a questo punto nel filmato a causa della creazione del disco DVD-Video corrente.

Commenti

Se è stata trovata una radice valida, questo metodo restituisce la stringa radice. In caso contrario, restituisce zero per pcbActualSize, a indicare che non è stata trovata o inizializzata una directory radice valida.

Requisiti

Requisito	Valore
Piattaforma di destinazione	Windows
Intestazione	strmif.h (include Dshow.h)

Vedi anche

Codici di errore e di esito positivo

Interfaccia ISourceInfo

Condividi tramite