Metodo IDeviceControl2::SetGPRM (strmif.h)

Articolo
03/05/2024

[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.

Il SetGPRM metodo imposta un valore di registro dei parametri generale.

Sintassi

HRESULT SetGPRM(
  [in]  ULONG   ulIndex,
  [in]  WORD    wValue,
  [in]  DWORD   dwFlags,
  [out] IDvdCmd **ppCmd
);

Parametri

[in] ulIndex

Registra indice; può essere un valore compreso tra zero e 15.

[in] wValue

Valore a 16 bit contenuto nel registro specificato.

[in] dwFlags

OR bit per bit di uno o più flag dall'enumerazione DVD_CMD_FLAGS , specificando come sincronizzare il comando.

[out] ppCmd

Riceve un puntatore a un oggetto IItemCmd che può essere utilizzato per sincronizzare i comandi DVD. Il chiamante deve rilasciare l'interfaccia. Questo parametro può essere NULL. Per altre informazioni, vedere Sincronizzazione dei comandi DVD.

Valore restituito

Restituisce uno dei valori seguenti.

Codice restituito	Descrizione
S_OK	Operazione completata.
E_INVALIDARG	Il parametro ulIndex è maggiore di 15 o qualsiasi altro parametro di input non è valido.

Commenti

Un disco DVD usa registri di parametri generali per archiviare vari tipi di informazioni. Impostando manualmente uno o più di questi registri, un'applicazione potrebbe essere in grado di fornire determinate funzionalità personalizzate. Si tratta di un comando avanzato e non deve essere usato a meno che non si abbia una conoscenza approfondita della specifica dvd.

La tabella seguente illustra il nome del comando Allegato J a cui corrisponde questo nome di metodo e i domini in cui questo metodo è valido.

Nome comando J allegato	Domini validi
Nessuno	Tutti

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	strmif.h (include Dshow.h)
Libreria	Strmiids.lib

Vedi anche

Applicazioni DVD

Codici di errore e di esito positivo

Interfaccia I AvessiControl2

IDeviceInfo2::GetAllGPRMs

Condividi tramite