共用方式為


AVC_FUNCTION_FIND_PEER_DO

AVC_FUNCTION_FIND_PEER_DO函式程式碼會尋找非虛擬 avc.sys 實例。

I/O 狀態欄塊

如果成功,AV/C 通訊協定驅動程式會將 Irp-IoStatus.Status > 設定為 STATUS_SUCCESS。

可能的其他傳回值包括:

傳回值 描述
STATUS_UNSUCCESSFUL 找不到 avc.sys 的非虛擬實例
STATUS_INVALID_GENERATION 在找到 Device Object 參考之前發生匯流排重設。 取得新的 NodeAddress,然後再試一次。

註解

此函式會使用 AVC_MULTIFUNC_IRB 結構的 PeerLocator 成員,如下所示。

typedef struct _AVC_MULTIFUNC_IRB {
  AVC_IRB  Common;
  union {
    .
    .
    .
    AVC_PEER_DO_LOCATOR PeerLocator;
 .
    .
    .
  };
} AVC_MULTIFUNC_IRB, *PAVC_MULTIFUNC_IRB;

規格需求

頭:avc.h中宣告。 包含 avc.h

AVC_MULTIFUNC_IRB輸入

通用
這個成員的 Function 子成員必須設定為 從AVC_FUNCTION列舉AVC_FUNCTION_FIND_PEER_DO

PeerLocator
指定avc.sys的非虛擬 (對等) 實例。

此函式會根據它所代表裝置的節點位址,找出非虛擬 avc.sys 實例。 如果找不到實例,IRP 會以狀態STATUS_UNSUCCESSFUL完成。 一旦找到實例,呼叫端即可透過 物件提交任何GUID_AVC_CLASS裝置介面要求。 呼叫端必須在完成時,透過 ObDereferenceObject) 釋放這個物件的參考 (。

此函式程式碼可以在 IRQL < = DISPATCH_LEVEL呼叫。

另請參閱

AVC_MULTIFUNC_IRB

AVC_PEER_DO_LOCATOR

AVC_FUNCTION

ObDereferenceObject