Share via


Método IDirect3DDeviceManager9::OpenDeviceHandle (dxva2api.h)

Obtém um identificador para o dispositivo Direct3D.

Sintaxe

HRESULT OpenDeviceHandle(
  [out] HANDLE *phDevice
);

Parâmetros

[out] phDevice

Recebe o identificador do dispositivo.

Retornar valor

O método retorna um HRESULT. Os possíveis valores incluem, mas sem limitação, aqueles na tabela a seguir.

Código de retorno Descrição
S_OK
O método foi bem-sucedido.
DXVA2_E_NOT_INITIALIZED
O gerenciador de dispositivos Direct3D não foi inicializado. O proprietário do dispositivo deve chamar IDirect3DDeviceManager9::ResetDevice.

Comentários

Para obter o ponteiro IDirect3DDevice9 do dispositivo Direct3D, chame IDirect3DDeviceManager9::LockDevice com o identificador retornado em phDevice. Feche o identificador do dispositivo quando terminar de usá-lo, chamando IDirect3DDeviceManager9::CloseDeviceHandle.

Para testar se um identificador de dispositivo ainda é válido, chame IDirect3DDeviceManager9::TestDevice.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho dxva2api.h

Confira também

Gerenciador de Dispositivos Direct3D

IDirect3DDeviceManager9