Função NdisRegisterDeviceEx (ndis.h)
A função NdisRegisterDeviceEx cria um objeto de dispositivo baseado nos atributos especificados.
Sintaxe
NDIS_STATUS NdisRegisterDeviceEx(
[in] NDIS_HANDLE NdisHandle,
[in] PNDIS_DEVICE_OBJECT_ATTRIBUTES DeviceObjectAttributes,
[out] PDEVICE_OBJECT *pDeviceObject,
[out] PNDIS_HANDLE NdisDeviceHandle
);
Parâmetros
[in] NdisHandle
Um identificador de driver de miniporta ou identificador de driver de filtro que o chamador obteve chamando o Função NdisMRegisterMiniportDriver ou a Função NdisFRegisterFilterDriver , respectivamente.
[in] DeviceObjectAttributes
Um ponteiro para um NDIS_DEVICE_OBJECT_ATTRIBUTES estrutura que contém os atributos do novo dispositivo.
[out] pDeviceObject
Um ponteiro que aponta para um ponteiro para uma estrutura de DEVICE_OBJECT recém-criada, se a chamada for bem-sucedida. Se a chamada falhar, pDeviceObject será definido para apontar para NULL.
[out] NdisDeviceHandle
Um ponteiro para uma variável fornecida pelo chamador na qual essa função, se for bem-sucedida, retornará um identificador para o objeto do dispositivo. Esse identificador é um parâmetro necessário para a função NdisDeregisterDeviceEx que o driver chama posteriormente.
Retornar valor
NdisRegisterDeviceEx retorna um dos seguintes valores de status:
Código de retorno | Descrição |
---|---|
|
NdisRegisterDeviceEx registrou com êxito o dispositivo. |
|
O chamador não é um driver NDIS. |
|
Falha na tentativa do driver de registrar o dispositivo. Normalmente, esse erro status é propagado de uma função NdisXxx ou de uma rotina de suporte no modo kernel. |
Comentários
Drivers de miniport e drivers de filtro podem chamar NdisRegisterDeviceEx para registrar um dispositivo virtual.
O driver deve chamar posteriormente a função NdisDeregisterDeviceEx quando o dispositivo não for mais necessário. Se NdisRegisterDeviceEx tiver alocado uma extensão, NdisDeregisterDeviceEx liberará a extensão.
Requisitos
Requisito | Valor |
---|---|
Cliente mínimo com suporte | Com suporte no NDIS 6.0 e posterior. |
Plataforma de Destino | Universal |
Cabeçalho | ndis.h (inclua Ndis.h) |
Biblioteca | Ndis.lib |
IRQL | PASSIVE_LEVEL |
Regras de conformidade da DDI | Irql_Miscellaneous_Function(ndis) |