DirectInputCreate
.gif "A hyphen indicates that the information in this topic is not relevant for this platform, or that the platform does not support the API that is listed.")
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
9/8/2008
Essa função é Não com suporte mais. Em versões anteriores, essa função criado um DirectInput objeto que com suporte a IDirectInput Interface COM.
Syntax
HRESULT WINAPI DirectInputCreate(
HINSTANCE hinst,
DWORD dwVersion,
LPDIRECTINPUT* lplpDirectInput,
LPUNKNOWN punkOuter
);
Parameters
hinst
Identificador de instância para o aplicativo ou dynamic-link library (DLL) que está criando a DirectInput WScript.Shell. DirectInput usa este valor para determinar se o aplicativo ou DLL tenha sido certificada e estabelecer quaisquer comportamentos especiais que podem ser necessários para compatibilidade com versões anteriores.É um erro para um DLL para transmitir o identificador para o aplicativo pai. De exemplo, um controle ActiveX incorporado em um página da Web que usa DirectInput deve transmitir seu próprio identificador instância e não o identificador para o navegador da Web. Isso garante que DirectInput reconhece o controle e pode habilitar qualquer comportamentos especiais que podem ser necessários.
- dwVersion
Número de versão DirectInput Para que o aplicativo foi projetado. Esse valor é normalmente DIRECTINPUT_VERSION. Passar o número versão de um versão anterior faz DirectInput Para emular dessa versão. Para obter mais informações, consulte Designing para versões anteriores do DirectInput.
- lplpDirectInput
Endereço de uma variável para receber um válido IDirectInput ponteiro interface se a chamar for bem-sucedido.
- punkOuter
Ponteiro para o endereço do objeto de controle IUnknown interface de agregação COM, ou NULL se a interface não é agregada. A maioria dos chamadores transmitir NULL. Se a agregação é solicitada, o objeto retornado na *lplpDirectInput é um ponteiro para o IUnknown, em vez de um IDirectInput interface, como exigido pelo agregação COM.
Return Value
Se a função for bem-sucedido, o valor de retorno é DI_OK. Se a função falhar, o valor de retorno pode ser uma do seguinte valores de erro.
| Valor | Descrição |
|---|---|
DIERR_BETADIRECTINPUTVERSION |
O aplicativo foi escrito para um sem suporte versão pré-lançamento do DirectInput. |
DIERR_INVALIDPARAM |
Um inválido parâmetro foi passado para a função retorno, ou o objeto não estava em um estado que permitido a função seja chamado. Esse valor é igual a padrão E_INVALIDARG valor de retorno COM. |
DIERR_OLDDIRECTINPUTVERSION |
O aplicativo requer uma versão mais recente do DirectInput. |
DIERR_OUTOFMEMORY |
O DirectInput subsistema não foi possível alocar memória suficiente para completo a chamar. Esse valor é igual a padrão E_OUTOFMEMORY valor de retorno COM. |
Remarks
Somente a versão Unicode desta função é com suporte.
Chamando a função com punkOuter = NULL é equivalente à criação de objeto através de CoCreateInstance (& CLSID_DirectInput, punkOuter, CLSCTX_INPROC_SERVER, & IID_IDirectInput, lplpDirectInput), em seguida, inicializando-lo com Inicializar.
Chamando a função com punkOuter ! = NULL é equivalente à criação de objeto através de CoCreateInstance(& CLSID_DirectInput, punkOuter, CLSCTX_INPROC_SERVER, & IID_IUnknown, lplpDirectInput). O objeto agregado deve ser inicializado manualmente.
Para determinar se a plataforma oferece suporte a essa função, consulte Determinando suporte COM APIs.
Requirements
| Header | dinput.h |
| Windows Embedded CE | Windows CE 2.12 through Windows CE .NET 4.1 |